Pelican, uz Python balstīts statisko vietņu ģenerators

par Pelikānu

Nākamajā rakstā mēs apskatīsim Pelican. Šī ir laba iespēja Python lietotājiem, kuri vēlas paši mitināt vienkāršu vietni vai emuāru. Ja jūs interesē izveidot pielāgotu vietni vai emuāru, šodien ir pieejamas daudzas iespējas. Bet ja nu vienīgi ja vēlaties rādīt statiskas tīmekļa lapas, šis statiskais vietņu veidotājs jums var būt noderīgs. Šāda veida lietojumprogrammas izmanto veidnes, lai izveidotu visas lietotāja vēlamās statiskās lapas un saistītu tās ar saistītajiem metadatiem.

Ja jūs izmantojat Pitons un jūs meklējat kaut ko statisku HTML lapu ģenerēšanai, šis ģenerators ļaus jums apskatīt iekšējo informāciju par tā darbību. Izmantojot zināmu valodu, ir vieglāk. Ja jums nepatīk Python, ir arī citi statiski vietņu ģeneratori, kas izmanto citas valodas.

Pelikāns ir parasti lietots statisko vietņu ģenerators, kas rakstīts Python. Austrumi tieši atbalsta reStructuredText un var atbalstīt Markdown, kad ir instalēta nepieciešamā pakotne. Visi uzdevumi tiek veikti, izmantojot komandrindas saskarnes rīkus (CLI), kas padara to vienkāršu ikvienam, kas to pazīst. Turklāt tās vienkāršais ātrās palaišanas rīks padara vietnes izveidi ārkārtīgi vienkāršu.

Pelikāna uzstādīšana un pamata konfigurācija

Es testēju šo programmu Ubuntu 20.04. Pirmais solis, kas jāievēro, būs izveidot a virtualenv un instalējiet Pelican. To var izdarīt, atverot termināli (Ctrl + Alt + T) un izmantojot tajā esošās komandas:

virtuālās vides izveidošana

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Pēc pip atjaunināšanas mēs tagad varam instalējiet Pelican:

Pelikāna iekārta

./venv/bin/pip install pelican

Palaidiet komandu pelican-quickstart

Pēc instalēšanas Pelican Quick Start CLI Tool izveidos pamata izkārtojumu un daži faili, lai mēs varētu sākt.

Lai viss būtu vienkāršs, ātrās palaišanas laikā es izmantoju nosaukuma un autora vērtības un atbildēju N uz raksta URL prefiksu un lappusēm. Pārējiem jautājumiem, es izmantoju noklusējumu. Vēlāk ir ļoti viegli mainīt šos iestatījumus konfigurācijas failā. Ātro sākumu var palaist ar komandu:

ātrais starta pelikāns

./venv/bin/pelican-quickstart

Kad tas ir izdarīts, mēs varam mainīt noteiktus iestatījumu aspektus. Mums vienkārši ir atveriet failu pelicanconf.py mūsu iecienītākajā teksta redaktorā.

konfigurācijas fails

Iekšpusē mēs varam meklēt līniju:

TIMEZONE = 'Europe/Paris'

Un mēs varam mainīt tās valsts laika joslu, kas jūs interesē.

līdz atjauniniet sociālo saišu iestatījumus, jums ir jāmeklē mainīgais SOCIĀLĀ en pelicanconf.py. Tajā mēs varam pievienot savas saites šādi:

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

Jāatzīmē, ka komats beigās ir svarīgs. Šis komats palīdz Python atpazīt, ka mainīgais faktiski ir kopa. Pārliecinieties, ka to neizdzēšat.

Sāciet serveri

Tagad, kad mums ir vietnes pamati, mēs varam redzēt, ka ātrā sākšana izveidoja Makefile dažādiem mērķiem. Viens no tiem ražo devserver var palaist mūsu serverī izstrādes serveri lai mēs varētu priekšskatīt visu, ko veidojam. Makefile izmantotajām CLI komandām vajadzētu būt mūsu PATH daļai, tāpēc vispirms mums jāaktivizē virtualenv.

startēt serveri

source ./venv/bin/activate

make devserver

Kad tas sākas, mēs varam atveriet mūsu pārlūkprogrammu un dodieties uz URL http://localhost:8000 lai redzētu izveidoto emuāru.

lapas paraugs, kas izveidots ar Pelican

Pievienot saturu

Tagad, kad mums ir pamata vietne, mēs varam pievienot kādu saturu. Pirmkārt, mēs izveidosim failu ar nosaukumu laipni lūdzam.pirmkārt satura direktorijā (saturs) vietnē.

Izmantojot mūsu iecienīto teksta redaktoru, mēs izveidosim šo failu ar tekstu, kas atbilst šādai struktūrai:

pievienot saturu pelikānā

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.).

Pēc faila rakstīšanas, izstrādātājam vajadzētu atjaunināt un ģenerēt kaut ko līdzīgu šim:

pievienots sveiciena fails

Pārlādējiet testa vietni pārlūkprogrammā, lai redzētu izmaiņas.

statiska sveiciena lapa

Metadati tika automātiski pievienoti lapai. Kas vēl, Pelican automātiski atklāja Intro kategoriju un pievienoja sadaļu augšējai navigācijai.

Mainiet tēmu

Papildus visam iepriekšminētajam mēs varam viegli mainīt tēmu. Krātuvē Pelikāna tēmas, jūs varat atrast dažādus lietotāju veidotus motīvus. Pārbaudīt jaunas tēmas ir ļoti vienkārši, jums tās vienkārši jāielādē no krātuves, saglabājiet tos mūsu datorā un failā pelicanconf.py pievienojiet šādu rindiņu ar tēmas ceļu:

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

Izstrādātājs atjaunos savu produkciju. Pārlūkprogrammā atkārtoti ielādējiet tīmekļa lapu, lai skatītu jauno motīvu.

Šis bija ātrs neliels ievads Pelicanā. Tas viss tika darīts ar vietējo mašīnu. Ja vēlaties, lai citi redzētu jūsu vietni, jums būs jāaugšupielādē iepriekš ģenerētie HTML faili serverī. Ja detalizēti aplūkojat izvadi pelikāns-ātrs starts, jūs redzēsit FTP, SSH, S3 un pat GitHub lapu izmantošanas iespējas.

Tā var iegūt vairāk informācijas par šo ģeneratoru projekta vietne vai jūsu GitHub krātuve.


Atstājiet savu komentāru

Jūsu e-pasta adrese netiks publicēta. Obligātie lauki ir atzīmēti ar *

*

*

  1. Atbildīgais par datiem: Migels Ángels Gatóns
  2. Datu mērķis: SPAM kontrole, komentāru pārvaldība.
  3. Legitimācija: jūsu piekrišana
  4. Datu paziņošana: Dati netiks paziņoti trešām personām, izņemot juridiskus pienākumus.
  5. Datu glabāšana: datu bāze, ko mitina Occentus Networks (ES)
  6. Tiesības: jebkurā laikā varat ierobežot, atjaunot un dzēst savu informāciju.