Maqaalka xiga waxaan ku eegi doonnaa Pelican. Kani waa ikhtiyaar wanaagsan oo adeegsadayaasha Python ee doonaya inay iskood u martigeliyaan degel ama baloog fudud. Haddii aad xiisaynayso abuuritaanka degel ama baloog caado ah, waxaad haysataa fursado badan oo maanta la heli karo. Laakiin haddii kaliya aad rabto inaad u adeegto bogagga mareegaha ee aan degganayn, dhisaha goobtan ma guurto ah ayaa laga yaabaa inay ku anfacdo. Noocyada codsiyada noocan ahi waxay adeegsadaan sheybaarro si ay u abuuraan dhammaan bogagga maan -galka ah ee adeegsaduhu doonayo, kuna xiro metadata la xidhiidha.
Hadaad isticmaasho Python oo aad raadinayso wax lagu abuuro bogag HTML ah oo taagan, matoorkani wuxuu kuu oggolaanayaa inaad fiiriso gudaha sida ay u shaqeyso. Adeegsiga luqad aad taqaan ayaa kuu sahlaysa. Haddii aadan jeclayn Python, waxaa jira soo -saareyaal kale oo goob -joog ah oo adeegsada luqado kale.
Pelican waa koronto -dhaliye goob caadi ah oo lagu isticmaalo Python. Bari si toos ah u taageera reStructuredText waxayna taageeri kartaa Markdown, marka xirmada loo baahan yahay la rakibo. Dhammaan shaqooyinka waxaa lagu sameeyaa iyada oo la adeegsanayo aaladaha is -dhexgalka taliska (CLI), taas oo u fududaynaysa qof kasta oo yaqaan. Waxaa intaa dheer qalabkeeda fudud ee bilowga deg -degga ah ayaa ka dhigaya abuuritaanka degel aad u fudud.
Rakibaadda Pelican iyo Qalabaynta Aasaasiga ah
Waxaan tijaabinayaa barnaamijkan Ubuntu 20.04. Tallaabada ugu horreysa ee la raaci doono waxay noqon doontaa abuuraan a virualenv oo rakibi Pelican. Tan waxaa lagu samayn karaa furitaanka terminal (Ctrl + Alt + T) oo la adeegsado amarada ku jira:
mkdir test-sitio cd test-sitio python3.8 -m venv venv ./venv/bin/pip install --upgrade pip
Ka dib markii la cusbooneysiiyay dhuumaha, hadda waan awoodnaa rakibi Pelican:
./venv/bin/pip install pelican
Samee amarka pelican-quickstart
Marka la rakibo, aaladda Pelican Quick Start CLI Tool ayaa abuuri doonta qaabka aasaasiga ah iyo faylasha qaarkood si aan u bilowno.
Si ay wax u fududaadaan, markaan si dhaqso leh u bilaabayo waxaan adeegsaday qiyamka cinwaanka iyo qoraaga oo waan ka jawaabay N horudhaca url -ka iyo qormada maqaalka. Su'aalaha intiisa kale, waxaan u isticmaalay habka caadiga ah. Aad bay u fududahay in la beddelo goobahan faylka qaabeynta goor dambe. Bilow degdeg ah waa la ordi karaa iyadoo amarka:
./venv/bin/pelican-quickstart
Marka la dhammeeyo, waxaan beddeli karnaa qaybo ka mid ah dejinta. Waa inaan yeelnaa ku fur faylka pelicanconf.py tifaftiraha qoraalka ee aan jeclahay.
Gudaha waxaan ka raadin karnaa khadka:
TIMEZONE = 'Europe/Paris'
Waana awoodnaa u beddel aagga waqtiga ee dalka ee adiga ku daneynaya.
para cusboonaysii goobaha isku xidhka bulshada, waa inaad raadisaa doorsoomaha BULSHADA en pelicanconf.py. Dhexdeeda waxaan ku dari karnaa xiriiriyaasheena sida soo socota:
SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)
Waa inaad ogaataa in kooma dhammaadka ahi muhiim yahay. Jumladaasi waxay ka caawineysaa Python inuu garto in doorsoomahu dhab ahaantii yahay go'an. Hubi inaadan tirtirin.
Bilow serverka
Hadda oo aan haysanno aasaaska goob, waxaan arki karnaa in deg -degga deg -degga ah uu sameeyay Makefile leh ujeeddooyin kala duwan. Mid ka mid ah ayaa sameeya devserver wuxuu ku bilaabi karaa server horumarineed mashiinkayaga si aan u eegno wax walba oo aan abuureyno. Amarada CLI ee loo adeegsado Makefile -ka ayaa loo malaynayaa inay qayb ka yihiin JIDKEENA, marka hore waa inaan dhaqaajino virtualenv.
source ./venv/bin/activate make devserver
Markay bilaabato, waan awoodnaa fur biraawsarkeena oo aad URL -ka http://localhost:8000 si aad u aragto baloogga la abuuray.
Ku dar nuxur
Hadda oo aan haysanno goob aasaasi ah, waxaan ku dari karnaa xoogaa nuxur ah. Marka hore, waxaan abuuri doonaa feyl la yiraahdo soo dhaweyn.da hore ee buugga tusmada (content) ee goobta.
Tifatiraha qoraalka aan jecel nahay, waxaan ku abuuri doonaa faylkaan qoraal la socda qaab dhismeedka soo socda:
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.).
Kadib qorista faylka, devserver waa inuu cusboonaysiiyaa oo abuuraa wax sidan oo kale ah:
Dib u soo celi goobta imtixaankaaga biraawsarka si aad u aragto isbeddelada.
Xog -ururinta si toos ah ayaa loogu daray bogga. Maxaa ka sii badan, Pelican waxay si otomaatig ah u ogaatay qaybta Intro waxayna ku dartay qaybta marawaxadda sare.
Beddel mawduuca
Waxaas oo dhan marka laga reebo, waxaan si fudud u beddeli karnaa mawduuca. Kaydinta Pelican-mawduucyada, waxaad ka heli kartaa mawduucyo kala duwan oo ay isticmaaleyaashu abuureen. Aad bay u fududahay in la tijaabiyo mawduucyada cusub, waa inaad ka soo dejisaa bakhaarka, ku keydi kombiyuutarkeena iyo faylka pelicanconf.py ku dar laynka soo socda waddada dulucda:
THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"
Devserver -ku wuxuu dib u soo noolayn doonaa wax soo saarkiisii. Dib -u -rar bogga shabakadda biraawsarka si aad u aragto mawduuca cusub.
Tani waxay ahayd hordhac yar oo degdeg ah Pelican. Waxaas oo dhan waxaa lagu sameeyay mashiin maxalli ah. Haddii aad rabto in dadka kale arkaan bartaada, waa inaad gelisaa faylasha HTML ee horay loo soo saaray server. Haddii aad si faahfaahsan u eegto wax soo saarka pelican-dhakhso u bilow, waxaad arki doontaa ikhtiyaarrada aad ku adeegsan karto FTP, SSH, S3, iyo xitaa bogagga GitHub.
Waxay noqon kartaa ka hel macluumaad dheeri ah oo ku saabsan koronto -dhaliyahaan gudaha websaydhka mashruuca ama adiga Bakhaarka GitHub.