Pelican, wani janareta na tushen tushen Python

game da Pelican

A cikin labarin na gaba za mu kalli Pelican. Wannan zaɓi ne mai kyau ga masu amfani da Python waɗanda ke son ɗaukar bakuncin gidan yanar gizo mai sauƙi ko blog. Idan kuna sha'awar ƙirƙirar gidan yanar gizon al'ada ko blog, kuna da zaɓuɓɓuka da yawa a yau. Amma idan kawai kuna son yin hidima ga shafukan yanar gizo a tsaye, wannan maginin rukunin yanar gizon na iya zama da amfani a gare ku. Waɗannan nau'ikan aikace -aikacen suna amfani da samfura don ƙirƙirar duk madaidaitan shafuka waɗanda mai amfani ke so, da haɗa su da metadata masu alaƙa.

Idan kayi amfani Python kuma kuna neman wani abu don samar da shafukan HTML a tsaye, wannan janareta zai ba ku damar duba abubuwan ciki na yadda yake aiki. Amfani da yaren da ka sani yana sauƙaƙa shi. Idan ba ku son Python, akwai wasu janareto na rukunin yanar gizon da ke amfani da wasu harsuna.

Pelican wani janareta ne da ake amfani da shi a tsaye wanda aka rubuta a cikin Python. Gabas kai tsaye yana tallafawa ReStructuredText kuma zai iya tallafawa Markdown, lokacin da aka shigar da kunshin da ake buƙata. Dukkan ayyuka ana yin su ta hanyar kayan aikin ƙirar layin umarni (CLI), wanda ke sauƙaƙa shi ga duk wanda ya saba da shi. Plusarin kayan aikin sa mai sauƙin sauri yana sa ƙirƙirar gidan yanar gizo mai sauƙi.

Shigarwa na Pelican da Kanfigareshi na asali

Ina gwada wannan shirin akan Ubuntu 20.04. Mataki na farko da za a bi zai kasance ƙirƙirar Kawai kuma shigar Pelican. Ana iya yin hakan ta hanyar buɗe tashar (Ctrl + Alt + T) da amfani da umarnin da ke ciki:

halittar muhallin mu'amala

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Bayan sabunta pip, zamu iya yanzu shigar Pelican:

Pelican makaman

./venv/bin/pip install pelican

Gudun umurnin pelican-quickstart

Da zarar an shigar, kayan aikin Pelican Quick Start CLI zai ƙirƙiri shimfidar asali da wasu fayiloli don mu fara.

Don sa abubuwa su kasance masu sauƙi, lokacin gudanar da saurin sauri Na yi amfani da ƙimar darajar take da marubuci kuma na amsa N zuwa prefix da url na labarin. Ga sauran tambayoyin, na yi amfani da tsoho. Abu ne mai sauqi don canza waɗannan saitunan a cikin fayil ɗin sanyi daga baya. Za a iya farawa da sauri tare da umarnin:

faststart pelican

./venv/bin/pelican-quickstart

Idan ya gama, za mu iya canza wasu fannoni na saitunan. Dole ne kawai mu yi bude fayil na pelicanconf.py a cikin editan rubutu da muka fi so.

fayil din daidaitawa

A ciki za mu iya neman layin:

TIMEZONE = 'Europe/Paris'

Kuma za mu iya canza zuwa yankin lokaci na ƙasar da ke sha'awar ku.

para sabunta saitunan haɗin gwiwar zamantakewa, dole ne ku nemi mai canzawa SOCIAL en pelicanconf.py. A ciki zamu iya ƙara hanyoyin haɗin mu kamar haka:

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

Ya kamata ku lura cewa waƙafi a ƙarshen yana da mahimmanci. Wannan waƙafi yana taimaka wa Python gane cewa mai canzawa ainihin saiti ne. Tabbatar cewa ba ku goge shi ba.

Fara uwar garke

Yanzu da muke da kayan yau da kullun na rukunin yanar gizo, zamu iya ganin cewa mai saurin sauri ya ƙirƙiri Makefile tare da manufofi daban -daban. Ofaya daga cikinsu yana yin devserver na iya fara sabar ci gaba akan injin mu don mu iya samfoti duk abin da muke ƙirƙira. Dokokin CLI da aka yi amfani da su a cikin Makefile yakamata su kasance wani ɓangare na PATH ɗin mu, don haka da farko dole ne mu kunna virtualenv.

fara sabar

source ./venv/bin/activate

make devserver

Lokacin farawa, zamu iya bude burauzan mu kuma je URL http://localhost:8000 don ganin blog ɗin da aka ƙirƙira.

samfurin shafin da aka kirkira da Pelican

Ƙara abun ciki

Yanzu muna da rukunin yanar gizo na asali, zamu iya ƙara wasu abubuwan ciki. Na farko, za mu ƙirƙiri fayil da ake kira barka da zuwa a cikin littafin abun ciki (abun ciki) shafin.

Tare da editan rubutun da muke so, za mu ƙirƙiri wannan fayil ɗin tare da rubutun da ke bin tsarin da ke gaba:

ƙara abun ciki a cikin pelican

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

Bayan rubuta fayil ɗin, devserver yakamata ya sabunta kuma ya samar da wani abu kamar haka:

an kara fayil maraba

Sake shigar da shafin gwajin ku a cikin mai bincike don ganin canje -canje.

a tsaye maraba shafi

An ƙara metadata ta atomatik zuwa shafin. Menene ƙari, Pelican ta gano rukunin Intro ta atomatik kuma ta ƙara sashin zuwa saman kewayawa.

Canja batun

Baya ga duk abubuwan da ke sama, muna iya sauƙaƙe batun. A cikin mangaza Pelican-jigogi, zaku iya samun jigogi daban -daban waɗanda masu amfani suka ƙirƙira. Abu ne mai sauqi don gwada sabbin jigogi, kawai dole ne ku sauke su daga ma'ajiyar ajiya, adana su akan kwamfutarmu kuma a cikin fayil ɗin pelicanconf.py ƙara layi mai zuwa tare da hanyar zuwa taken:

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

Mai ba da sabis zai sake sabunta fitowar sa. Sake loda shafin yanar gizon a cikin mai bincike don ganin sabon jigo.

Wannan karamin gabatarwa ne mai sauri ga Pelican. Duk wannan an yi shi ne a kan injin gida. Idan kuna son wasu su ga rukunin yanar gizon ku, dole ne ku loda fayilolin HTML da aka riga aka ƙirƙira zuwa sabar. Idan ka duba dalla -dalla a fitowar pelican-saurin farawa, zaku ga zaɓuɓɓuka don amfani da FTP, SSH, S3, har ma da shafukan GitHub.

Zai iya zama sami ƙarin bayani game da wannan janareta a cikin aikin yanar gizo ko a cikin ku Ma'ajin GitHub.


Bar tsokaci

Your email address ba za a buga. Bukata filayen suna alama da *

*

*

  1. Wanda ke da alhakin bayanan: Miguel Ángel Gatón
  2. Manufar bayanan: Sarrafa SPAM, sarrafa sharhi.
  3. Halacci: Yarda da yarda
  4. Sadarwar bayanan: Ba za a sanar da wasu bayanan ga wasu kamfanoni ba sai ta hanyar wajibcin doka.
  5. Ajiye bayanai: Bayanin yanar gizo wanda Occentus Networks (EU) suka dauki nauyi
  6. Hakkoki: A kowane lokaci zaka iyakance, dawo da share bayanan ka.