-
Notifications
You must be signed in to change notification settings - Fork 440
Move docs to github pages #864
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
I f... up and accidentally pushed into this repository instead of my own (for template testing for enqueue github pages). I've force pushed master back into previous state, but you might want @makasim to enable strict checks against pushing to master: |
Few people have access to the repo. The restriction would make their life harder. It does not bother me much, at least now. Let's keep it as is. |
Good idea with gh pages. I'll give it a try. |
@makasim If you don't mind I'll simply give you colabolator status on the fork, so you'll be able to check how it looks without affecting current master branch (since afaik you can either have gh-pages branch, master branch in root, or master branch in EDIT: Done so. Other themes you can check at https://help.github.com/en/articles/adding-a-jekyll-theme-to-your-github-pages-site if you prefer something different. |
@makasim You'll probably need to enable github pages in https://github.com/php-enqueue/php-enqueue settings for github to pick up the pages. It should show |
fixed |
Documentation in current form, while works great, requires traversing "source code" of repository. It might be beneficial to use gh-pages to show documentation only.
It should be little cost to enable it. As a matter of fact, @makasim you can already do so in repository settings by going to https://github.com/php-enqueue/enqueue-dev/settings and choosing
/docs
from master as gh-pages source. Conveniently .md files can be used and Github uses Jekyll to build the site.I've taken the liberty and enabled it on my own repository and added a custom theme, which allows creating sidebar menu (for a relatively complex docs structure should be a nice addition - see 2. refence below). Link to template is available so you can see if "white" colour scheme is more to your liking.
See: https://steveb-p.github.io/enqueue-dev/
References:
https://help.github.com/en/articles/user-organization-and-project-pages
https://pmarsceill.github.io/just-the-docs/
When enabled, gh-pages will show under:
https://enqueue-php.github.com/enqueue-dev
(unless you make a organization repository names
enqueue-php
)The text was updated successfully, but these errors were encountered: