From 32c154be95cd71ea96284b1dbee1d3fa04a9adb1 Mon Sep 17 00:00:00 2001 From: Brandon B Date: Fri, 28 Apr 2017 19:18:44 -0700 Subject: [PATCH] Update tips.rst I found that one of the easiest ways to publish to GitHub User Pages is to make Pelican a subdirectory within the ``.github.io`` project, then generate the output files in the root level of ``.github.io`` and push the entire project to GitHub. --- docs/tips.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/tips.rst b/docs/tips.rst index 50160380..bf0b3599 100644 --- a/docs/tips.rst +++ b/docs/tips.rst @@ -98,6 +98,18 @@ by the ``ghp-import`` command) to the ``elemoine.github.io`` repository's To publish your Pelican site as User Pages, feel free to adjust the ``github`` target of the Makefile. + +Another option for publishing to User Pages is to generate the output files in the root directory of the project. + +For example, your main project folder is ``.github.io`` and you can create the Pelican project in a subdirectory called ``Pelican``. Then from inside the ``Pelican`` folder you can run:: + + $ pelican content -o .. -s pelicanconf.py + +Now you can push the whole project ``.github.io`` to the master branch of your GitHub repository:: + + $ git push origin master + +(assuming origin is set to your remote repository). Custom 404 Pages ----------------