Creați-vă propriul site pe github

Puțini oameni știu că Github, cu excepția găzduirii excelente a proiectelor dvs. Git, poate găzdui și site-ul personal. De exemplu, acest blog este situat pe acesta. În primul meu articol, vă voi arăta cum să configurați această funcție cât mai convenabil posibil.







În primul rând, trebuie să fii un utilizator Github înregistrat și să poți lucra cu sistemul de control al versiunii Git. Să presupunem că sunteți gata.

În viitor, voi da exemple pentru site-ul meu: klen.github.com

Prefer să generez pagini la nivel local și să verific rezultatul fără descărcarea conținutului de pe Github. Sunt mai familiarizat cu lucrul cu Python, așa că folosesc Pelican ca generator de site-uri. Mai jos vă voi arăta cum să o puneți și să o puneți la lucru.

Se presupune că sunteți familiarizat cu Python și VirtualEnv.

  1. De când vom folosi Pelican, trebuie să oprim generatorul Github Jekyll încorporat. Aceasta se face prin adăugarea fișierului .nojekyll la rădăcina depozitului.
  1. Acum creați și activați mediul virtual pentru modulele site-ului nostru:






  1. Instalați generatorul Pelican și motorul de șablon Jinja2 necesar în VirtualEnv creat de noi:
  1. Vom păstra sursa site-ului în subdirectorul sursă. și a creat pagini statice în rădăcina depozitului, astfel încât Github le vede. Creați fișierul sursă / hello.rst cu primul nostru articol:

Eu folosesc sintaxa RST. Dar puteți utiliza Markdown pentru site-ul dvs. Doar păstrați fișierele cu extensia * .md Pelican suporta alte formate, dar este necesar să se stabilească modulele corespunzătoare.

Opțiunea -o. forțează Pelican să construiască static în rădăcina proiectului.

Dacă totul a mers bine în rădăcina proiectului, veți vedea mai multe fișiere HTML. Deschideți index.html în browserul dvs. și căutați pe site-ul dvs. Web.

  1. Acum, schimbările noastre pot fi salvate în Git și trimise la Github.

Vom configura site-ul nostru și vom automatiza operațiunile de rutină puțin.

  1. Creați fișierul de configurare al sursei site-ului / settings.py:

Aflați mai multe despre setările Pelican. poate fi citit în documentația sa.

  1. Pentru a simplifica asamblarea, creați un fișier .compile sh

Și dați-i dreptul de a executa:

Acum, în directorul de proiect, puteți apela și de a colecta ./.compile statice chiar și fără activarea mediul virtual.

  1. Următorul pas este crearea cârligului Git pentru generarea automată a site-ului la comitete. Creați și editați fișierul .git / hooks / pre-commit:

Nu uitați să faceți acest lucru executabil.

Cu fiecare comitere de modificări la depozit, proiectul va fi re-compilat automat.







Articole similare

Trimiteți-le prietenilor: