Tekstovi Projekti Autor


Osnovna upotreba nanoblogger alata


[datum] 2009-10-19

Sadržaj:
Upravljanje nanoblogger sadržajem:
Konkretni primeri upotrebe

nanoblogger (u daljem tekstu NB) je Gnu Bash skripta čiji je cilj da vam omogući kreiranje bloga pomoću alata poput Vim, nano, pico, joe uređivača teksta, cat, cp, cut, dirname, date, grep, mkdir, mv, rm, sed i sort alata i sl.. NB je specifican po tome što kreira blog koji sadrži statične xHTML strane stoga vam nisu neophodne *SQL i/ili slične baze za blog niti PHP, JS i sl.

NB je alat kojim je lako ovladati i znajte da on nudi mnogo ukoliko izdvojite malo slobodnog vremena za učenje. Izgled samih blogova se moze menjati (preko CSS-a i samih HTML šablona), mogu se koristiti dodaci (pluginovi) koji NB mogu da pretvore u mnogo moćan alat za pisanje blogova... Mogućnosti su (skoro) neograničene ali za potpuno razumevanje NB alata su vam neophodna znanja o bash skriptanju, HTML kodiranju i solidno znanje Engleskog jezika (sva dokumentacija je na Engleskom). U ovom tekstu ću vam dati osnovne informacije o tome kako koristiti NB za kreiranje blogova, kako konfigurisati blogove i kako manipulisati tekstovima.

Instalacija


Instalacija se moze izvrsiti na 2 načina: putem menadžera paketa unutar vaše distribucije ili skidanjem arhive sa zvanicnog NB sajta.
Prva varijanta je relativno jednostavna budući da je neophodno da pokrenete vas menadžer paketa (apt-get, Synaptic, yum, zypp, Yast ilineki drugi) i izaberete paket "nanoblogger". Ovako ce sve putanje i sve datoteke biti konfigurisane! Mala napomena: ovakav način instalacije neće kreirati blog za vas već će samo izvršiti konfiguraciju samog programa!

Drugi nacin zahteva malo podešavanja i njega ćemo detaljnije objasniti:
1. Prvo preuzmite NB arhivu sa zvanicnog sajta: http://nanoblogger.sourceforge.net
2. Preuzetu arhivu (nanoblogger-xx.tar.gz gde je XX verzija) raspakujte na željenu lokaciju.
3. Potrebno je da promenite $PATH na vašem računaru kako bi uključili lokaciju raspakovanog NB alata. Ovaj korak nije obavezan niti potreban ali je poželjan. Dakle, unutar vaseg ~./.bashrc fajla je neophodno da promenite "PATH" i da dodate putaju do direktorijuma u koji ste raspakovali NB.
! Pažnja: Putanje se odvajaju sa ":" stoga vasu NB putanju morate odvojiti tim karakterom (primer: PATH="/usr/bin:/usr/sbin" mora biti PATH="/usr/bin:/usr/sbin:").
Ukoliko ste sve dobro podesili, sledeća komanda bi trebalo da vam da informacije o verziji NB-a koju ste instalirali:
nb --version
Ako je sve proslo kako treba, uspešno ste instalirali NB!


Kreiranje bloga


Kreiranje novog bloga se vrsi sledecom komandom:
nb -b BLOG_DIR add weblog

BLOG_DIR predstavlja putanju do bloga koji želite da napravite!
Info: ova putanja ne mora da postoji zato što će je NB sam napraviti.

Prilikom kreiranja ćete biti upitani da li želite da konfigurišete nov blog odmah. Preporučujem da pročitate nastavak teksta pre nego što odgovorite sa Y (Y = Yes = Da). Ukoliko odgovorite sa "N" (N = No = Ne) blog će kreirati neophodne fajlove i ostaviće blog nekonfigurisan.



Konfiguracija


NB blog se može konfigurisati i ta konfiguracija se čuva unutar direktorijuma gde se blog nalazi u blog.conf datoteci. Ta datoteka tj. konfiguracija je izuzetno dobro organizovana i sadrži objašnjenja za svaku opciju u samom fajlu (na Engleskom je). Neke od bitnih promenljivih cemo dati ovde:

NB_EDITOR - uređivač teksta koji želite koristiti za pisanje tekstova (vim, nano, geany, gedit...)
NB_BROWSER - veb pregledač koji koristite (firefox, opera, chrome...)
BLOG_TITLE - naslov tj. "ime" bloga koji pišete
BLOG_AUTHOR - autor bloga (korisnički nalog je podrazumevana (default) opcija)
ENTRY_ARCHIVES - kreiranje individualnih arhiva za svaki unos
MONTH_ARCHIVES - kreiranje individualnih arhiva za svaki mesec
YEAR_ARCHIVES - kreiranje individualnih arhiva za svaku godinu

Imajte u vidu da mnoge opcije u konfiguraciji nisu ovde objašnjene! Da bi razumeli značenje svih podešavanja otvorite blog.conf unutar vašeg blog direktorijuma i pažljivo procitajte svaki red teksta! Još jednom napominjem da je tekst na Engleskom stoga vam je neophodno poznavanje istog.

Kada podesite sve parametre unutar blog.conf datoteke, neophodno je da obnovite kompletan blog (sve strane) kako bi videli promene. To možete učiniti sledećom komandom:
nb -b PUTANJA_DO_BLOGA update all

Sada bi trebalo da sve radi onako kako vi želite.



Kreiranje unosa


Kreiranje unosa se vrši sledećom komandom:
nb -b BLOG_DIR add entry

Nakon ove komande će biti otvoren šablon za tekstove koji morate ispuniti za ispravno kreiranje unosa. Šablon izgleda ovako:
TITLE:
AUTHOR: krak
DATE:
DESC:
FORMAT: raw
-----
BODY:


END-----

Da bi vas tekst bio ispravno formatiran neophodno je da vaš šablon izgleda ovako (daću kompletan primer):
TITLE: Moj prvi dan u školi (i ne tako dobar)
AUTHOR: krak
DATE:
DESC:
FORMAT: raw
-----
BODY:

Moj prvi dan u školi nije baš bio dobar zato što su me gađali kiflama i polivali jogurtom... Deca u školi umeju ponekad da budu okrutna.

END-----

Kao sto se da videti iz primera TITLE je naslov vaseg unosa dok sve što se nalazi između BODY: i END----- je sadržaj unosa tj. sam tekst unosa. Ostale redove nemojte menjati (pogotovo ne DATE deo ukoliko ne znate šta radite).



Kategorisanje unosa


Svaki tekst može se može svrstati u jednu ili više kategorija.
Primer: ako napišemo tekst koji sadrži informacije o novoj matičnoj ploči koju je izdala ta i ta kompanija taj tekst možemo (ali ne moramo) kategorizovati pod "hardver" kategorijom. NB podržava dodavanje kategorija tekstovma. Evo kako da to izvedete:

1. Prvo morate da proverite listu katergorija koju imate unutar vaseg bloga komandom
nb -b BLOG_DIR list tags

Lista tagova (tagovi su isto što i kategorije) će izgledati ovako:
ID, Naslov

 1, nanoblogger-help
 2, hardver

Tagovi su predstavljeni brojevima i te brojeve morate uneti prilikom kreiranja samog teksta (ukoliko isti želite da ubacite u određenu kategoriju).

2. Unos možete ubaciti u kategoriju na 2 načina:

-1- Prilikom kreiranja samog unosa mozete dodati kategoriju sledecom
komandom:
nb -b BLOG_DIR --tag BROJ_KATEGORIJE add entry

BROJ_KATEGORIJE predstavlja broj kategorije koju želite dodati (u gore navedenom primeru bi broj 2 bila hardver kategorija). Dobijanje broja kategorije smo gore objasnili.

-2- Unosi mogu biti kategorizovani i nakon pisanja. Za to vam je neophodno da prvo saznate ID članka (tj. unosa) koji predstavlja broj. Taj broj možemo dobiti/proveriti sledećom komandom:
nb -b BLOG_DIR list entry

Ova komanda ce vam dati sledeće izlazne informacije (ovo dole je samo primer, kod vas može biti drugačije):
ID, Naslov - (Datum) - [Tag ID(ovi)]

 1, Dobrodosli u NanoBlogger 3.4! - (2009-10-13 01:55:48) - [1]

Sada znamo da je unos pod imenom "Dobrodosli u NanoBLogger 3.4!" broj 1 tj. ID unosa je 1.
Da bi dodali kategoriju, već postojećem unosu, koristićemo sledeću komandu:
nb -b BLOG_DIR --tag BROJ_KATEGORIJE tag-entry BROJ_UNOSA

BROJ_KATEGORIJE je broj kategorije (objašnjeno je gore kako doći do broja kategorije) dok je BROJ_UNOSA ID tj. broj unosa (takodje je objašnjeno gore).

Primer: Želimo da unos "Dobrodosli u NanoBlogger 3.4!" ubacimo u "nanoblogger-help" kategoriju. Evo jednog gotovog primera (na osnovu informacija koje smo dali gore kao i izlaznih informacija do sada):
krak [nanoblogger-3.4.1] $: ./nb -b ~/krak list tags
ID, Title

 1, nanoblogger-help
 2, hardver

krak [nanoblogger-3.4.1] $: ./nb -b ~/krak list entry
ID, Title - (Date) - [Tag ID(s)]
 1, Dobrodosli u NanoBlogger 3.4! - (2009-10-13 01:55:48) - [1]

krak [nanoblogger-3.4.1] $: ./nb -b ~/krak --tag 1 tag-entry 1
selected tag id(s): 1 ...
 1 (1=Dobrodosli u NanoBlogger ..) ...
updating main database ...
generating weblog files ...
initializing main database ...
generating atom 1.0 feed ...
/home/krak/krak/atom.xml
generating recent entries links ...
generating rss 2.0 feed ...
/home/krak/krak/rss.xml
generating weblog links ...
generating weblog status ...
generating articles: /home/krak/krak/articles ...
generating archive index page ...
/home/krak/krak/archives/index.html
generating archives ...
/home/krak/krak/archives/nanoblogger-help/index.html
generating year archives ...
/home/krak/krak/archives/2009/index.html
/home/krak/krak/archives/2009/10/index.html
/home/krak/krak/archives/2009/10/13/dobrodosli_u_nanoblogger_3_4/index.html
generating main index page(s) ...
/home/krak/krak/index.html
expiring cache data ...

krak [nanoblogger-3.4.1] $:




Menjanje unosa


Da bi izmenili već unet tekst neophodno je koristite sledecć komandu:
nb -b BLOG_DIR edit entry BROJ_UNOSA

BROJ_UNOSA je ID tj. broj unosa koji želite menjati!



Konkretni primeri upotrebe NB-a


Svestan sam činjenice da NB nije jednostavan alat i da povremeno ume da zbunjuje korisnike. Da bi vam olakšao upotrebu ovog alata, sumiraću vam listu komandi koje mozete svakodnevno koristiti za upotrebu. Pre nego što počnemo naglasiću da sam (u mom slučaju) podesio $PATH stoga ću NB pozivati komandom nb. Ukoliko ne podesite $PATH onda ćete morati da se prebacite u direktorijum gde se NB nalazi (komadnom cd) i odatle pozivate komandu nb.
Primer: ukoliko ste instalirali NB u ~/nanoblogger-3.4.1 a niste
podesili
$PATH (niste dodali :~/nanoblogger-3.4.1: u ~/.bashrc) onda moramo prvo da pokrenemo komandu
cd ~/nanoblogger-3.4.1

Nakon ove komande možete nastaviti da pratite ovaj tekst.

Pa da pocnemo:
Kreiraćemo novi blog u ~/moj_blog
nb -b ~/moj_blog add weblog

Ova komanda će izbaciti izlazne informacije poput ovih:


creating weblog directory '/home/krak/moj_blog' ...
copying default weblog files ...
would you like to configure the new weblog now? [Y/n]
:

Ukoliko odgovorite sa Y onda će vas skripta prebaciti u tekstualni editor za podešavanje opcija koje su vezane za funkcionisanje NB-a (ime
vašeg bloga, vaše ime, koliko članaka zelite da vidite na index strani...). Ukoliko odgovorite sa N onda će skripta da nastavi rad i moraćete ručno da otvorite blog.conf koji se nalazi u ~/moj_blog.

Kada podesite blog koritite sledeću komandu za osvežavanje istog i primenjivanje tih podešavanja:
nb -b ~/moj_blog update all


Kreiracemo novi unos (entry) sledećom komandom:
nb -b ~/moj_blog add entry

Nakon ove komande, otvoriće nam se šablon za unos novog teksta. Novi unos ćemo da nazovemo "Moj prvi NB tekst" a sadržaj tog unosa će da bude "Mnogo volim NB i linuks.". To znaci da će nas šablon za unos izgledati ovako:
TITLE: Moj prvi NB tekst
AUTHOR: krak
DATE:
DESC:
FORMAT: raw
-----
BODY:

Mnogo volim NB i linuks.

END-----

Sačuvajte tekst, izađite iz uređivača teksta i pustite skriptu da kreira novi tekst.

Sada ćemo da izlistamo sve tekstove unutar naše blog arhive (unutar ~/moj_blog) komandom
nb -b ~/moj_blog list entry

Ovakva komanda će nam dati sledeće izlazne informacije:
ID, Title - (Date) - [Tag ID(s)]
 1, Moj prvi NB tekst - (2009-10-19 15:47:02)
 2, Welcome to NanoBlogger 3.4! - (2009-10-19 15:37:38) - [1]

Imajte u vidu da će se ovde nalaziti drugačija lista ukoliko već imate tekstove u arhivi. Budući da smo mi tek kreirali naš blog, mi imamo samo 2 teksta: jedan koji smo mi uneli i jedan koji je podrazmevani unos.
Brojevi pored testova su ID-evi tekstova! To je bitno da zapamtite.

Možemo da izlistamo i kategorije u našoj blog arhivi sledećom komadnom:
nb -b ~/moj_blog list tags

što nam daje sledeće informacije:
ID, Title
 1, nanoblogger-help

Iz ovoga zaključujemo da je broj "1" zapravo ID kategorije koja se zove "nanoblogger-help".

Dodaćemo novu kategoriju i nazvaćemo je "tekstovi". Komanda za to je:
nb -b ~/moj_blog add tag

Nakon ove komande, skripta će vas pitati za ime nove kategorije. Izlazne informacije treba da izgledaju ovako:
creating new tag id: 2 ...
enter name for the new tag [Untitled]
:

Unesite tekstovi i pritisnite taster ENTER.
! Primetite da piše "creating new tag id: 2 ..." čime saznajemo da će kategorija "tekstovi" imati ID "2".

Sada možemo da proverimo listu tagova ponovo:
nb -b ~/moj_blog list tags

što će nam dati sledeće izlazne informacije:
ID, Title
 1, nanoblogger-help
 2, tekstovi

Kao što vidimo, kategorija tekstovi ima ID "2".

Hajde da dodamo tekstove kategorijama. Unosu čiji je ID "1" ("Moj prvi NB tekst") ćemo dodati kategoriju čiji je ID "2" ("tekstovi"). Komanda za to glasi:
nb -b ~/moj_blog --tag ID_KATEGORIJE tag-entry ID_TEKSTA

što znači da ćemo mi upisati sledeće:
nb -b ~/moj_blog --tag 2 tag-entry 1


Izlazne informacije će izgledati ovako:
selected tag id(s): 2 ...
 1 (1=Moj prvi NB tekst..) ...
updating main database ...
generating weblog files ...
initializing main database ...
generating recent entries links ...
generating rss 2.0 feed ...
/home/krak/moj_blog/rss.xml
generating weblog links ...
generating weblog status ...
generating articles: /home/krak/moj_blog/articles ...
generating archive index page ...
/home/krak/moj_blog/archives/index.html
generating archives ...
/home/krak/moj_blog/archives/tekstovi/index.html
generating year archives ...
/home/krak/moj_blog/archives/2009/index.html
/home/krak/moj_blog/archives/2009/10/index.html
/home/krak/moj_blog/archives/2009/10/19/moj_prvi_nb_tekst/index.html
generating main index page(s) ...
/home/krak/moj_blog/index.html
expiring cache data ...


Sada ćemo da izmenimo unos. Recimo da unos, čiji je ID "1" ("Moj prvi NB tekst") želimo da promenimo. Komanda za to je:
nb -b ~/moj_blog edit entry ID_UNOSA

što znači da ćemo mi da kucamo
nb -b ~/moj_blog edit entry 1

Otvoriće vam se tekst koji možete da menjate.

Toliko od mene za ovaj put. Mislim da sam dobro objasnio osnove upotrebe.


vrh strane ↑


Ukoliko nije drugačije naglašeno, sav sadržaj na ovom sajtu je pod WTFPL (v2) licencom
2008-danas djura-san