Lokalno editovanje stranica

Zašto?

• Vežbaćete Git!
• Nećete puniti javnu istoriju projekta svojim eksperimentima.

Kako?

• Instalirati Ruby i RubyGems.

• Instalirati potrebne Ruby gemove lokalno (zato što nije svemu mesto u /usr-u... ili jeste?)

$ export GEM_HOME=$HOME/.gem          # ova linija ide i u shell startup script (.bashrc, ...)
$ export PATH=$PATH:$HOME/.gem/bin    # kao i ova
$ export RB_USER_INSTALL=1            # Ako ste na FreeBSD-u (neki gemovi bez ovoga zahtevaju root privilegije pri instalaciji)
$ gem install jekyll
$ gem install gollum                  # ako editujemo wiki strane
$ gem install rdiscount               # ako koristimo markdown i editujemo wiki strane

Instalacija ovih gemova moze zahtevati prethodnu instalaciju paketa kao sto je libxml2-dev. Ko proveri, neka javi.

• Izgenerišite HTML sadržaj i startujte server na default portu 4000

$ git clone [email protected]:haklabbeograd/haklabbeograd.github.com.git
$ cd haklabbeograd.github.com
$ jekyll --server

• Posle editovanja fajlova, ažurirajte sadržaj

$ jekyll

• Za lokalni editing wiki strana (wiki server slusa na portu 4567):

$ git clone [email protected]:haklabbeograd/haklabbeograd.github.com.wiki.git
$ cd haklabbeograd.github.com.wiki
$ gollum

Upozorenje:

Ne znam da li github koristi aktuelni rdiscount gem, ali lokalno izrenderovan wiki markdown izgleda potpuno drugačije od onoga koji se izrenderuje na serveru. Preporučujem korišćenje drugog markup jezika za wiki, zbog ove razlike u markdown procesorima.

Jekyll koristi Maruku markdown procesor, pa strane lokalno izgledaju kao na serveru. Maruku i rdiscount očigledno drugačije razumeju markdown.