git-pages
v0.8.1
Published
Run your own github-like static pages
Downloads
88
Readme
git-pages
Run your own github-like static pages
Demo on Heroku - might be asleep.
We love Github pages - a great way to show small JS / HTML library in action. A lot of our public repos have them, but what about the private repos? There is no way (aside from buying Github Enterprise) to have privately hosted static pages from a list of your private repos. Unless you use git-pages! Just install, put names of repos into a config file and start using Node.
The main index page shows list of pulled repos. Click on the "open" link to open the statically hosted site pointing at the desired branch. Click "pull" to fetch the latest code.
Install
- Install globally
npm install -g git-pages
to run as a CLI in any folder - Install as a dependency
npm install --save git-pages
to start as NPM script from another project
Serve single repo
If you just need to pull a repo and statically serve a single file, use command line arguments. For example to serve the RevealJs presentation from https://github.com/kubawalinski/ndc2015-testjs you can execute this command
git-pages --repo [email protected]:kubawalinski/ndc2015-testjs.git --page slides-testjs.html
Run git-pages --help
to see all options and shortcuts.
Configure
Create git-pages.configure.js
file that exports the configuration options, for example,
here are 2 repos to be hosted under http://localhost:8765/code-box
and
http://localhost:8765/local-angular
.
module.exports = {
repos: {
'code-box': {
// you can use full git@ url
git: '[email protected]:bahmutov/code-box.git',
// or the full HTTPS url
// git: 'https://github.com/bahmutov/code-box.git',
// pick the index page from the repo, supports HTML, Markdown, Jade
index: 'demo.html' // default is index.html,
exec: 'npm install' // command to execute after pulling latest code, optional
},
'local-angular': {
git: 'bahmutov/local-angular-development',
branch: 'gh-pages' // pick branch other than master
},
'local-folder': {
// copy and serve a local folder instead of Git repo
folder: '/path/to/foo'
}
},
storagePath: '/tmp/git-pages', // local temp folder, optional, leave it to OS tmp dir
port: 8765 // serving port, optional
};
For our example, see git-pages.config.js
Note: some hosting environments, like Heroku do not support pulling repos via SSH without additional setup, thus they require HTTPS git urls.
Run
Run after installing globally git-pages
Run after installing as a dependency (via package.json script)
"scripts": {
"pages": "git-pages"
},
"dependencies": {
"git-pages": "0.2.0"
}
Then you can start the git-pages
server by simply npm run pages
.
Run from the cloned folder
- simple start
node index.js
ornpm run start
- run with automatic restart and watching source files
npm run watch
. Uses nodemon.
Todo
- [ ] webhook to allow pulling on commit
- [x] execute shell commands after pulling, for example
npm install
orbower install
- [x] form full SSH or HTTPS urls from user / repo name pair
Small print
Author: Kensho © 2015
Support: if you find any problems with this library, open issue on Github
MIT License
The MIT License (MIT)
Copyright (c) 2015 Kensho
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.