Bene… dopo neanche 24 ore dall’upload dell’alpha release 0.1.0 di Rog ho gia’ dovuto uploadarne una versione 0.1.1 e 0.1.2 :-)

Dopo aver costretto alessandro (mods) a provare a gem-installare il pacchetto mediante il comando:

ripley@ubik:/home/ripley$ gem install rog -r

Abbiamo subito verificato che andava aggiunta una dipendenza al mio pacchetto in formato gem :

• syntax (utilizzato nella pipeline dei post per formattare il codice ruby contenuto nella macro code)

Mediante syntax potremo inserire in un post:

.#:code#ruby#
   def metodo1
     puts "hello" 
   end
.#:code#

per ottenere il seguente effetto nell’html generato:

  def metodo1
    puts "hello"
  end

bello, no? :-)

Ma de ce sta cuntamu?

Rog : un piccolo blog engine che anziche’ operare sul server (e quindi necessitare di uno spazio web con scripting), genera una serie di pagine html da uploadare su un normale web server (senza db o scripting) a partire da una serie di file di testo (formattati in textile) ed alcuni file ruby.

La domanda che sorge spontanea e’... era necessario?

beh necessario no… ma divertente si :-)

In pratica e’ un blogengine per geek e per morti di fame :-) senza spazio web dotato di db e scripting.

Magari puo’ essere uno stimolo per cominciare ad usare/imparare ruby :-) per me lo e’ stato :-P

E comu se usa?

Avete ragione… un getting started migliore potevo anche farlo :-)

Installazione

Prima di tutto dovete avere ruby... e’ importante! e’ importante! :-)

cercare di usare rog senza ruby ed erb
e' come cercare di avere la conoscenza senza la saggezza e il
senso del sacro!!! Immppazzisci e ti escono le bbolle dal naso!

Ue! e’ una citazione non sono pazzo!!! :-))))

Quindi… per non fare le bolle dal naso e’ necessario che vi procuriate ruby, erb e rubygems ... ma niente paura:

Se usate Debian o derivate vi bastera’ lanciare da linea di comando:

ripley@ubik:/home/ripley$ apt-get install ruby eruby

Altrimenti verificate la presenza di pacchetti simili per la vostra distribuzione. Nel peggiore dei casi potete scaricarvi i sorgenti e fare da voi:

• Ruby
• ERuby

Per rubygems scaricate tranquillamente i sorgenti e seguitene le istruzioni:

• RubyGems Download

Installato rubygems vi risultera’ molto facile procurarvi rog come molte altre applicazioni ruby distribuite in questo modo.

RubyGems e' un sistema di pacchettizzazione per applicazioni e librerie
ruby, simile a CPAN di perl,
molto semplice e molto potente (sia per l'utente che per lo sviluppatore)

Ora siete pronti… e con un semplice:

ripley@ubik:/home/ripley$ gem install rog -r

Dovrebbe installarvi (chiedendovi conferma) rog e relative dipendenze.

Creare un nuovo blog

Per creare un nuovo blog userete il vostro nuovo comando rog:

ripley@ubik:/home/ripley$ rog create myblog
cp -r /usr/lib/ruby/gems/1.8/gems/rog-0.1.0/lib/rog/project myblog
ripley@ubik:/home/ripley$ cd myblog/
ripley@ubik:/home/ripley/myblog$ ls
README  Rakefile  blog
ripley@ubik:/home/ripley/myblog$

blog e’ la directory in cui si trovano:

• blog/blog.yaml : il file di configurazione principale del blog
• blog/layout : qui si trovano i layout in erb (html misto a ruby… simile a come avviene in php)
• blog/pages : qui si trovano l’index del blog, l’about e le altre pagine singole in stile rote che vorrete inserire nel blog
• blog/pages/archives : dove vengono creati le pagine di archivio tag e month
• blog/pages/posts : dove vengono create le pagine dei post

Configurare il blog

Il file blog.yaml e’ il file di configurazione principale del blog, e il suo contenuto e’ abbastanza autoesplicativo:

blogurl: http://myblogurl/
publish_url: myuser@myblogurl:/home/myuser/public_html
blog_title: Im mio blog
blog_subtitle varie ed eventuali
pages:
 - About: about.html
 - Blog: index.html
buttons:
 - rog_powered.png: http://rog.rubyforge.org
 - ruby_powered.png: http://www.ruby-lang.it
 - emacs_powered.png: http://www.gnu.org/software/emacs
 - gnulinux_powered.png: http://www.gnu.org
projects:
 - your project: http://projecturl
links:
 - yourlink1: http://yourlink1url
 - yourlink2: http://yourlink2url

In particolare:

• publish_url: e’ l’url in formato rsync per l’upload delle pagine
• blog_title: e’ il titolo del blog
• blog_subtitle: e’ il sottotitolo del blog

gli altri sono i nomi, le immagini e gli url corrispondenti ai link del menu’ e i bottoni powered.

Un altro file da modificare prima di iniziare il blogging e’ blog/pages/COMMON.rb:

@site_title = "titolo html del mio blog"

dove site_title rappresenta la stringe che appare nella barra del titolo del browser.

I blog, You blog

Ora potete cominciare a bloggare:

ripley@ubik:/home/ripley/myblog$ rake create_post
Post name: titolo_post
tags: miotag1 miotag2

In questo modo verranno creati 2 file in blog/pages/posts nel formato YYYYMMDD-nomepost.(rb|rhthml):

20060516-titolo_post.rb 20060516-titolo_post.thtml

nel primo (un file ruby di fatto) vengono impostati titolo e tag del post:

  #Set var for post title and tags
  @page_title = "prova123"
  @page_tags = ['prova','test','pippo']

nel secondo (formattato in textile) il testo del post:

inserire il test in textile qui

Creare gli archivi

Per auto-generare i file di archivio dei post potremo usare i task:

• create_tag_archive : per creare l’archivio dei post relativi ad un certo tag

• create_month_archive

creare un tag-archivio si riduce a eseguire:

ripley@ubik:/home/ripley/myblog$ rake create_tag_archive
Tag name: mio_tag1

creare un month-archivio:

ripley@ubik:/home/ripley/myblog$ rake create_month_archive
Year: 2006
Month: 05

Generare l’output html del blog

Niente di piu’ semplice:

ripley@ubik:/home/ripley/myblog$ rake

Rimuove i vecchi html e li rigenera’. L’output finisce nella directory output, e puntandoci il nostro browser potremo gustare una preview del blog che andremo ad uploadare.

Upload del blog sul webserver

La directory output contiene l’intero blog e quindi e’ sufficiente upload-arla sul server in qualche modo.

Se sul server avete a disposizione un account ssh ed rsync dovrete semplicemente (dopo aver configurato correttamente la variabile publish_url nel file di configurazione blog.yaml) dare un:

ripley@ubik:/home/ripley/myblog$ rake publish
Password:

ed il gioco e’ fatto.

Ed ora?

Per avere altre informazioni sulle possibilita’ di rog potete leggerne il codice sorgente (ovviamente rilasciato secondo GPL) oppure approfondire rote su cui e’ basato la maggior parte dell’engine.

Tenete conto inoltre che ogni post puo’ contenere codice ruby, e che rote supporta la creazione i filtri e altre cose divertenti quindi se sapete usare ruby o avete intenzione di imparare potrete manipolarlo a vostro piacimento.

Buon divertimento, rpl

---