Osnove upotrebe NanoBlogger alata

• 1Ovo se svidja korisniku: mcrule
  
  Registruj se da bi pohvalio/la poruku!

NanoBlogger

NanoBLogger (u daljem tekstu NB) je Gnu Bash skripta ciji je cilj da vam omoguci kreiranje bloga pomocu alata poput Vim|nano|pico|joe tekst editora, cat, cp, cut, dirname, date, grep, mkdir, mv, rm, sed i sort alata. NanoBlogger je specifican po tome sto kreira blog koji sadrzi staticne HTML (xhtml 1.1 tacnije) strane stoga vam nisu neophodne *sql ili slicne baze za blog niti PHP, JavaScript i sl.
NB nije alat kojim je lako ovladati ali znajte da on nudi mnogo ukoliko izdvojite malo slobodnog vremena. Izgled samih blogova se moze drasticno menjati (preko CSS-a i samih HTMl sablona), mogu se koristiti dodaci (pluginovi) koji NB mogu da pretvore u mnogo mocan alat za pisanje blogova... Mogucnosti su (skoro pa) neogranicene 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 cemo 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 nacina: putem menadzera paketa unutar vase distribucije ili skidanjem arhive sa zvanicnog NB sajta.
Prva varijanta je relativno jednostavna buduci da je neophodno da pokrenete vas menadzer paketa (apt-get, Synaptic, yum, zypp, Yast ili neki drugi) i izaberete paket "nanoblogger". Ovako ce sve putanje i svi fajlovi biti konfigurisani! Mala napomena: ovakav nacin instalacije nece kreirati blog za vas vec samo izvrsiti konfiguraciju samog programa!.
Drugi nacin zahteva malo podesavanja i njega cemo detaljnije objasniti:
1. Prvo skinite NB arhivu sa zvanicnog sajta (http://nanoblogger.sourceforge.net)
2. Skinutu arhivu (nanoblogger-xx.tar.gz gde je XX verzija) raspakujte na zeljenu lokaciju.
3. Potrebno je da promenite $PATH na vasem racunaru kako bi ukljucili lokaciju raspakovanog NB alata. Ovaj korak nije obavezan niti potreban ali je pozeljan. Dakle unutar vaseg ~./.bashrc fajla je neophodno da promenite "PATH" i da dodate putaju do direktorijuma u koji ste raspakovali NB. Paznja: Putanje se odvajaju sa ":" stoga vasu NB putanju morate odvojiti tim karakterom (primer: PATH="/usr/bin:/usr/sbin" ce postati PATH="/usr/bin:/usr/sbin:"). Ukoliko ste sve dobro podesili, sledeca komanda bi trebalo da vam da informacije o verziji NB-a koju ste instalirali:
nb --version

Ako je sve proslo kako treba, uspesno ste instalirali NB



Kreiranje bloga i konfiguracija
Kreiranje bloga
Kreiranje novog bloga se vrsi sledecom komandom:
nb -b PUTANJA_DO_BLOGA add weblog
PUTANJA_DO_BLOGA (u daljem tekstu BLOG_DIR) predstavlja putanju do bloga koji zelite da kreirate! Paznja: ova putanja ne mora da postoji zaista i NB ce je automatski kreirati.

Prilikom kreiranja cete biti upitani da li zelite da konfigurisete nov blog odmah. Preporucujemo da procitate nastavak teksta pre nego sto odgovorite sa "Y" (sto znaci "Da"). Ukoliko odgovorite sa "N" (sto znaci "Ne") blog ce kreirati neophodne fajlove i ostavice blog nekonfigurisan.


Konfiguracija
NB blog se moze konfigurisati i ta konfiguracija se cuva unutar direktorijuma gde se blog nalazi u fajlu "blog.conf". Taj fajl tj. konfiguracija je izuzetno dobro organizovana i sadrzi objasnjenja za svaku opciju u samom fajlu (na Engleskom je). Neke od bitnih promenljivih cemo dati ovde:
NB_EDITOR- tekst editor koji zelite koristiti za pisanje tekstova (vim, nano, geany, gedit...)
NB_BROWSER- ime omiljenog veb pretrazivaca (firefox, opera, chrome...)
BLOG_TITLE- naslov tj. "ime" bloga koji pisete
BLOG_AUTHOR- autor bloga (po defaultu koristi username korisnickog nalova na racunaru)
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 objasnjene! Da bi razumeli znacenje svih podesavanja otvorite "blog.conf" unutar vaseg blog direktorijuma i pazljivo procitajte svaki red teksta! Jos jednom napominjemo da je tekst na Engleskom stoga vam je neophodno poznavanje istog.
Kada podesite sve parametre unutar "blog.conf" fajla neophodno je da obnovite kompletan blog (sve strane) kako bi videli unete promene. To mozete uciniti sledecom komandom:
nb -b PUTANJA_DO_BLOGA update all

Sada bi trebalo da sve radi onako kako vi zelite.



Kreiranje tekstova, menjanje (vec unetih) tekstova i dodavanje istih kategorijama
Kreiranje unosa
Kreiranje unosa se vrsi sledecom komandom:
nb -b BLOG_DIR add entry
Nakon ove komande ce biti otvoren sablon fajl koji morate ispuniti za ispravno kreiranje unosa. Sablon izgleda ovako:
TITLE:
AUTHOR: krak
DATE:
DESC:
FORMAT: raw
-----
BODY:

END-----

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

Moj prvi dan u skoli nije bas bio dobar zato sto su me gadjali kiflama i polivali jogurtom... Deca u skoli umeju ponekad da budu okrutna :(

END-----

Kao sto se da videti iz primera "TITLE" je naslov vaseg unosa dok sve sto se nalazi izmedju "BODY:" i "END-----" je sadrzaj unosa tj. sam tekst unosa. Ostale redove nemojte menjati (pogotovo ne "DATE" deo ukoliko ne znate sta radite).


Kategorisanje unosa
Svaki tekst moze sadrzati kategoriju. Primer: ako napisemo tekst koji sadrzi informacije o novoj maticnoj ploci koju je izdala ta i ta kompanija taj tekst mozemo (ali ne moramo) kategorizovati pod "hardver" kategorijom. NB podrzava dodavanje kategorija tekstovma. Evo kako da to izvedete:
1. Prvo morate da proverite listu katergorija koju imate unutar vaseg bloga komadnom
nb -b BLOG_DIR list tags

Lista tagova (tagovi su isto sto i kategorije) ce izgledati ovako:
ID, Naslov
 1, nanoblogger-help
 2, hardver
Tagovi su predstavljeni brojevima i te brojeve morate uneti prilikom kreiranja samog teksta (ukoliko isti zelite da ubacite u odredjenu kategoriju).

2. Unos mozete ubaciti u kategoriju na 2 nacina:
-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 zelite 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 clanka koji predstavlja broj. To mozemo proveriti sledecom komandom:
nb -b BLOG_DIR list entry

Ova komanda ce vam dati sledece izlazne informacije:
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, vec postojecem unosu, koristicemo sledecu komandu:
nb -b BLOG_DIR --tag BROJ_KATEGORIJE tag-entry BROJ_UNOSA
BROJ_KATEGORIJE je broj kategorije (objasnjeno je gore kako doci do broja kategorije) dok je BROJ_UNOSA ID tj. broj unosa (takodje je objasnjeno gore).

Primer: Zelimo da unos "Dobrodosli u NanoBlogger 3.4!" kategorizujemo pod "nanoblogger-help". Evo jednog gotovog primera (na osnovu inforamcija koje smo dali gore kao i izlaznih informacija):
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 vec unet tekst neophodno je koristite sledecu komandu:
nb -b BLOG_DIR edit entry BROJ_UNOSA
BROJ_UNOSA je ID tj. broj unosa koji zelite menjati!




Konkretni primeri upotrebe NB-a
Svesni smo cinjenice da NB nije jednostavan alat i da povremeno ume da zbunjuje korisnike. Da bi vam olaksali upotrebu ovog alata, sumiracemo vam listu komandi koje mozete svakodnevno koristiti za upotrebu. Pre nego sto pocnemo naglasicemo da smo (u nasem slucaju) podesiti $PATH stoga cemo NB pozivati komandom nb. Ukoliko ne podesite $PATH onda cete morati da se prebacite u direktorijum gde se NB nalazi (komadnom cd) i odatle pozivate komandu nb. Primer: ukoliko smo instalirali NB u ~/nanoblogger-3.4.1 a nismo podesili $PATH (nismo dodali ":~/nanoblogger-3.4.1:" u ~/.bashrc) onda moramo prvo da pokrenemo komandu
cd ~/nanoblogger-3.4.1
Nakon ove komande mozete nastaviti da pratite tekst.

Pa da pocnemo:

Kreiracemo novi blog u ~/moj_blog
nb -b ~/moj_blog add weblog
Ova komanda ce vam dati 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 ce vas skripta prebaciti u tekstualni editor za podesavanje opcija koje su vezane za funkcionisanje NB-a (ime vaseg bloga, vase ime, koliko clanaka zelite da vidite na index strani...). Ukoliko odgovorite sa "N" onda ce skripta da nastavi rad i moracete rucno da otvorite blog.conf koji se nalazi u ~/moj_blog.

Kada podesite blog koritite sledecu komandu za osvezavanje istog i primenjivanje tih podesavanja:
nb -b ~/moj_blog update all


Kreiracemo novi unos (entry) sledecom komandom:
nb -b ~/moj_blog add entry

Nakon ove komande, tovorice nam se sablon za unos novog teksta. Novi unos cemo da nazovemo "Moj prvi NB tekst" a sadrzaj tog unosa ce da bude "Mnogo volim NB i linuks.". To znaci da ce nas sablon za unos izgledati ovako:
TITLE: Moj prvi NB tekst
AUTHOR: krak
DATE:
DESC:
FORMAT: raw
-----
BODY:

Mnogo volim NB i linuks.

END-----

Pritisnite ENTER i pustite skriptu da kreira novi tekst.


Sada cemo da izlistamo sve tekstove unutar nase blog arhive (unutar ~/moj_blog) komandom
nb -b ~/moj_blog list entry
Ovakva komanda ce nam dati 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 ce ove stojati drugacija lista ukoliko vec imate tekstove u arhivi. Buduci da smo mi tek kreirali nas 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.


MOzemo da izlistamo i kategorije u nasoj blog arhivi sledecom komadnom:
nb -b ~/moj_blog list tags
sto ce nam dati sledece informacije
ID, Title
 1, nanoblogger-help
Iz ovoga zakljucujemo da je broj "1" zapravo ID kategorije koja se zove "nanoblogger-help".


Dodacemo novu kategoriju. Novu kategoriju cemo da nazovemo "tekstovi". KOmanda za to je:
nb -b ~/moj_blog add tag
Nakon ove komande, skripta ce vas pitati za ime nove kategorije. Izlazne inforacije izgledaju ovako:
creating new tag id: 2 ...
enter name for the new tag [Untitled]
:

Unesite "tekstovi" i pritisnite ENTER.
Primetite da pise "creating new tag id: 2 ..." cime saznajemo da ce kategorija "tekstovi" imati ID "2".


Sada mozemo da proverimo listu tagova ponovo:
nb -b ~/moj_blog list tags
sto ce nam dati sledece izlazne informacije:
ID, Title
 1, nanoblogger-help
 2, tekstovi

Kao sto vidimo, kategorija tekstovi ima ID "2".


Ajmo sada da dodamo tekstove kategorijama. Unosu ciji je ID "1" ("Moj prvi NB tekst") cemo dodati kategoriju ciji je ID "2" ("tekstovi"). Komanda za to glasi:
nb -b ~/moj_blog --tag ID_KATEGORIJE tag-entry ID_TEKSTA
sto znaci da cemo mi upisati sledece
nb -b ~/moj_blog --tag 2 tag-entry 1

Izlazne inforacije ce 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 cemo da izmenimo unos. Recimo da unos ciji je ID "1" ("Moj prvi NB tekst") zelimo da promenimo. Komanda za to je:
nb -b ~/moj_blog edit entry ID_UNOSA
sto znaci da cemo mi da kucamo
nb -b ~/moj_blog edit entry 1

Otvorice vam se tekst koji mozete da mejate.

To bi bilo to. Nadamo se da smo vam ovim prakticnim primerima dali dovoljno materijala za eksperimentisanje.