Pelican, Python-pohjainen staattinen sivustogeneraattori

Pelicanista

Seuraavassa artikkelissa tarkastelemme Pelicania. Tämä on hyvä vaihtoehto Python-käyttäjille, jotka haluavat itse isännöidä yksinkertaista verkkosivustoa tai blogia. Jos olet kiinnostunut luomaan mukautetun verkkosivuston tai blogin, sinulla on tänään monia vaihtoehtoja. Mutta jos vain Jos haluat näyttää staattisia verkkosivuja, tämä staattinen sivustonrakentaja voi olla hyödyllinen sinulle. Tämäntyyppiset sovellukset luovat mallien avulla kaikki käyttäjän haluamat staattiset sivut ja linkittävät ne niihin liittyviin metatietoihin.

Jos käytät Python ja etsit jotain staattisten HTML -sivujen luomiseen, tämän generaattorin avulla voit tarkastella sisäisesti, miten se toimii. Käyttämäsi kielen osaaminen helpottaa sitä. Jos et pidä Pythonista, on olemassa muita staattisia sivustogeneraattoreita, jotka käyttävät muita kieliä.

Pelican on yleisesti käytetty staattinen sivustogeneraattori, joka on kirjoitettu Pythonilla. Itään tukee suoraan reStructuredText ja voi tukea Markdownia, kun tarvittava paketti on asennettu. Kaikki tehtävät suoritetaan komentorivin käyttöliittymän työkalujen (CLI), mikä tekee siitä yksinkertaisen kaikille sen tunteville. Lisäksi sen yksinkertainen pikakäynnistyökalu tekee verkkosivuston luomisesta erittäin helppoa.

Pelican -asennus ja perusasetukset

Testaan ​​tätä ohjelmaa Ubuntu 20.04: llä. Ensimmäinen seuraava askel on luo a virtualenv ja asenna Pelican. Tämä voidaan tehdä avaamalla päätelaite (Ctrl + Alt + T) ja käyttämällä siinä olevia komentoja:

virtuaalisen ympäristön luominen

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

./venv/bin/pip install --upgrade pip

Pipin päivittämisen jälkeen voimme nyt asenna Pelican:

Pelikaani

./venv/bin/pip install pelican

Suorita pelican-quickstart -komento

Asennettuaan Pelican Quick Start CLI -työkalu luo perusasettelun ja joitain tiedostoja, jotta voimme aloittaa.

Jotta asiat olisivat yksinkertaisia, käytin pikakäynnistyksen aikana otsikon ja tekijän arvoja ja vastasin N artikkelin url -etuliitteeseen ja sivunumerointiin. Loput kysymykset, käytin oletusarvoa. Näiden asetusten muuttaminen asetustiedostossa on erittäin helppoa myöhemmin. Pika -aloitus voidaan suorittaa komennolla:

pika -pelikaani

./venv/bin/pelican-quickstart

Kun se on tehty, voimme muuttaa tiettyjä asetuksia. Meidän on vain pakko avaa pelicanconf.py -tiedosto suosikkitekstieditorissamme.

määritystiedosto

Sisältä voimme etsiä linjaa:

TIMEZONE = 'Europe/Paris'

Ja voimme vaihda sinua kiinnostavan maan aikavyöhykkeelle.

että päivitä sosiaalisen linkin asetukset, sinun on etsittävä muuttuja SOSIAALI- en pelicanconf.py. Siihen voimme lisätä linkkimme seuraavasti:

SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)

Huomaa, että lopussa oleva pilkku on tärkeä. Tämä pilkku auttaa Pythonia tunnistamaan, että muuttuja on itse asiassa joukko. Varmista, ettet poista sitä.

Käynnistä palvelin

Nyt kun meillä on sivuston perusteet, voimme nähdä, että pika -aloitus loi Makefilen, jolla oli erilaisia ​​tavoitteita. Yksi heistä tekee devserver voi käynnistää koneemme kehityspalvelimen jotta voimme esikatsella kaikkea luomamme. Make -tiedostossa käytettyjen CLI -komentojen on tarkoitus olla osa PATH: iamme, joten ensin meidän on aktivoitava virtualenv.

käynnistä palvelin

source ./venv/bin/activate

make devserver

Kun se alkaa, voimme avaa selaimesi ja siirry URL -osoitteeseen http://localhost:8000 nähdäksesi luodun blogin.

mallisivu luotu Pelicanilla

Lisää sisältöä

Nyt kun meillä on perussivusto, voimme lisätä sisältöä. Ensimmäinen, luomme tiedoston nimeltä tervetuloa. ensimmäinen sisältöhakemistossa (pitoisuus) sivustosta.

Suosikkitekstieditorimme avulla luomme tämän tiedoston tekstillä, joka noudattaa seuraavaa rakennetta:

lisää sisältöä pelikaani

Bienvenid@ a este blog

######################

:date: 20210827 00:03

:tags: bienvenid@

:category: Intro

:slug: bienvenida

:author: ubunlog

:summary: Documento bienvenida

Bienvenid@ a este blog de prueba con Pelican.

Esta es una pequeña página se va a mostrar como página estática.
Pelican analiza automáticamente las líneas de metadatos (fecha, etiquetas, etc.).

Kun olet kirjoittanut tiedoston, kehittäjän pitäisi päivittää ja luoda jotain tällaista:

tervetulotiedosto lisätty

Lataa testisivustosi uudelleen selaimessa nähdäksesi muutokset.

staattinen tervetulosivu

Metatiedot lisättiin automaattisesti sivulle. Lisäksi, Pelican havaitsi automaattisesti Intro -luokan ja lisäsi osion ylimpään navigointiin.

Vaihtaa aihetta

Kaiken edellä mainitun lisäksi voimme helposti vaihtaa puheenaihetta. Varastossa Pelikaani-teemoja, löydät erilaisia ​​teemoja, jotka käyttäjät ovat luoneet. Uusien teemojen testaaminen on erittäin helppoa, sinun on vain ladattava ne arkistosta, tallenna ne tietokoneellemme ja lisää tiedostoon pelicanconf.py seuraava rivi teeman polun kanssa:

THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"

Kehityspalvelin uudistaa tuotoksensa. Lataa uusi sivu selaimesta nähdäksesi uuden teeman.

Tämä oli nopea esittely Pelicaniin. Kaikki tämä tehtiin paikallisella koneella. Jos haluat muiden näkevän sivustosi, sinun on ladattava valmiiksi luodut HTML-tiedostot palvelimelle. Jos tarkastelet yksityiskohtaisesti tuotosta pelikaani-pika-aloitus, näet vaihtoehdot käyttää FTP-, SSH-, S3- ja jopa GitHub -sivuja.

Se voi lisätietoja tästä generaattorista projektin verkkosivusto tai omassa GitHub-arkisto.


Jätä kommentti

Sähköpostiosoitettasi ei julkaista. Pakolliset kentät on merkitty *

*

*

  1. Vastuussa tiedoista: Miguel Ángel Gatón
  2. Tietojen tarkoitus: Roskapostin hallinta, kommenttien hallinta.
  3. Laillistaminen: Suostumuksesi
  4. Tietojen välittäminen: Tietoja ei luovuteta kolmansille osapuolille muutoin kuin lain nojalla.
  5. Tietojen varastointi: Occentus Networks (EU) isännöi tietokantaa
  6. Oikeudet: Voit milloin tahansa rajoittaa, palauttaa ja poistaa tietojasi.