github/pelican
1
0
Fork 1
mirror of https://github.com/getpelican/pelican.git synced 2025-10-15 20:28:56 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge df22dd9798 into 25732f7be6

Browse source
This commit is contained in:
Aaron Bennett 2017-01-24 07:19:31 +00:00 • committed by GitHub
commit 035cd65199
1 changed files with 8 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

23
docs/tips.rst
View file

@ -30,7 +30,7 @@ For Apache::
ErrorDocument 404 /404.html ErrorDocument 404 /404.html
For Amazon S3, first navigate to the ``Static Site Hosting`` menu in the For Amazon S3, first navigate to the ``Static Site Hosting`` menu in the
bucket settings on your AWS cosole. From there:: bucket settings on your AWS console. From there::
Error Document: 404.html Error Document: 404.html
@ -66,16 +66,12 @@ the content of the ``output`` directory (creating the branch if it doesn't
already exist). The ``git push origin gh-pages`` command updates the remote already exist). The ``git push origin gh-pages`` command updates the remote
``gh-pages`` branch, effectively publishing the Pelican site. ``gh-pages`` branch, effectively publishing the Pelican site.
.. note::
The ``github`` target of the Makefile (and the ``gh_pages`` task of the Fabfile)
created by the ``pelican-quickstart`` command
publishes the Pelican site as Project Pages, as described above.
.. note:: ghp-import on Windows **\*Note:** The ``github`` target of the Makefile (and the ``gh_pages`` task of the Fabfile) created by the ``pelican-quickstart`` command publishes the Pelican site as Project Pages, as described above.
Until `ghp-import Pull Request #25 <https://github.com/davisp/ghp-import/pull/25>`_ **\*Note for ghp-import on Windows**: Until `ghp-import Pull Request #25 <https://github.com/davisp/ghp-import/pull/25>`_
is accepted, you will need to install a custom build of ghp-import: is accepted, you will need to install a custom build of ghp-import:
``pip install https://github.com/chevah/ghp-import/archive/win-support.zip`` ``pip install https://github.com/chevah/ghp-import/archive/win-support.zip``
User Pages User Pages
---------- ----------
@ -94,10 +90,7 @@ The ``git push`` command pushes the local ``gh-pages`` branch (freshly updated
by the ``ghp-import`` command) to the ``elemoine.github.io`` repository's by the ``ghp-import`` command) to the ``elemoine.github.io`` repository's
``master`` branch on GitHub. ``master`` branch on GitHub.
.. note:: **\*Note:** To publish your Pelican site as User Pages, feel free to adjust the ``github`` target of the Makefile.
To publish your Pelican site as User Pages, feel free to adjust the
``github`` target of the Makefile.
Custom 404 Pages Custom 404 Pages
---------------- ----------------
@ -108,7 +101,7 @@ relevant `GitHub docs <https://help.github.com/articles/custom-404-pages/>`_.
Extra Tips Extra Tips
---------- ----------
Tip #1: **Tip #1:**
To automatically update your Pelican site on each commit, you can create To automatically update your Pelican site on each commit, you can create
a post-commit hook. For example, you can add the following to a post-commit hook. For example, you can add the following to
@ -116,7 +109,7 @@ a post-commit hook. For example, you can add the following to
pelican content -o output -s pelicanconf.py && ghp-import output && git push origin gh-pages pelican content -o output -s pelicanconf.py && ghp-import output && git push origin gh-pages
Tip #2: **Tip #2:**
To use a `custom domain To use a `custom domain
<https://help.github.com/articles/setting-up-a-custom-domain-with-pages>`_ with <https://help.github.com/articles/setting-up-a-custom-domain-with-pages>`_ with