mirror of
https://github.com/getpelican/pelican.git
synced 2025-10-15 20:28:56 +02:00
33 lines
963 B
ReStructuredText
33 lines
963 B
ReStructuredText
Tips
|
|
####
|
|
|
|
Here are some tips about Pelican that you might find useful.
|
|
|
|
Publishing to GitHub
|
|
====================
|
|
|
|
GitHub comes with an interesting "pages" feature: you can upload things there
|
|
and it will be available directly from their servers. As Pelican is a static
|
|
file generator, we can take advantage of this.
|
|
|
|
The excellent `ghp-import <https://github.com/davisp/ghp-import>`_ makes this
|
|
really easy. You will have to install it::
|
|
|
|
$ pip install ghp-import
|
|
|
|
Then, given a repository containing your articles, you would simply have
|
|
to run Pelican and upload the output to GitHub::
|
|
|
|
$ pelican -s pelican.conf.py .
|
|
$ ghp-import output
|
|
$ git push origin gh-pages
|
|
|
|
And that's it.
|
|
|
|
If you want, you can put that directly into a post-commit hook, so each time you
|
|
commit, your blog is up to date on GitHub!
|
|
|
|
Put the following into `.git/hooks/post-commit`::
|
|
|
|
pelican -s pelican.conf.py . && ghp-import output && git push origin
|
|
gh-pages
|