Pour publier des pages GitHub, j'ai créé une page en utilisant Pelican, un générateur HTML statique réalisé par Python. J'étais accro à la libération, alors prenez note de la procédure sous forme de mémorandum. La procédure détaillée est très utile car le site de référence suivant est détaillé, il est donc bon de travailler sur cette base.
# pip install pelican
# pip install ghp-import
Créez un référentiel à partir de la page Pages GitHub. Il existe deux types, un pour les utilisateurs et un pour les projets, mais cette fois je l'ai créé pour les utilisateurs.
Clonez le référentiel.
# git clone <URL du référentiel>
# pelican-quickstart
> Where do you want to create your new web site? [.]
> What will be the title of this web site? yusukew62 blog
> Who will be the author of this web site? yusukew62
> What will be the default language of this web site? [en] ja
> Do you want to specify a URL prefix? e.g., http://example.com (Y/n) Y
> What is your URL prefix? (see above example; no trailing slash) http://yusukew62.github.io
> Do you want to enable article pagination? (Y/n) Y
> How many articles per page do you want? [10]
> What is your time zone? [Europe/Paris] Asia/Tokyo
> Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n) Y
> Do you want an auto-reload & simpleHTTP script to assist with theme and site development? (Y/n) Y
> Do you want to upload your website using FTP? (y/N) N
> Do you want to upload your website using SSH? (y/N) N
> Do you want to upload your website using Dropbox? (y/N) N
> Do you want to upload your website using S3? (y/N) N
> Do you want to upload your website using Rackspace Cloud Files? (y/N) N
> Do you want to upload your website using GitHub Pages? (y/N) y
> Is this your personal page (username.github.io)? (y/N) y
Done. Your new project is available at /root/testpelican
Une fois pelican-quickstart terminé, les fichiers suivants seront créés.
Makefile content develop_server.sh fabfile.py output pelicanconf.py publishconf.py
Créez un article à publier dans le répertoire de contenu. Cette fois, j'ai créé un article avec reStructuredText, qui ressemble plus à Python. Lors de la création avec Markdown, placez Markdown à partir de pip.
# vi content/20161210.rst
Exemple d'article
First Post By Pelican
#####################
:date: 2016-12-08 12:00
:modified: 2016-12-10 14:40
:tags: Python, Pelican
:category: Python
:authors: yusukew62
:summary: first post by pelican
.. code-block:: python
print "Hello World"
Générez un fichier html.
# make html
Vérifiez l'affichage.
# make serve
Connectez-vous à l'adresse IP de l'hôte d'exécution ci-dessus avec un navigateur sur le port 8000.
Exportez le fichier publié sur les pages GitHub dans la branche gh-pages.
# ghp-import output
Ajoutez le fichier html généré à votre référentiel local.
# git add output/
# git commit -m 'Added all created html files'
Publier un ensemble de fichiers de la branche gh-pages vers la branche master du référentiel distant
# git push -f origin gh-pages:master
Après un certain temps, assurez-vous que la page est actualisée.
La branche gh-pages n'inclut pas le répertoire de contenu ou le fichier de paramètres pélican (* .py), donc coupez une autre branche et poussez-la. Ici, il est créé en tant que branche appelée source from master et téléchargé vers un référentiel distant.
# git branch source
# git push origin source
Accédez à partir d'un navigateur et vérifiez
http://<Nom d'utilisateur>.github.io
Je me suis référé au site suivant. Comment créer un blog géré par Pelican + Markdown + GitHub Pages
Recommended Posts