rog Tag Archive

Rog-0.1.5 e Community

(2006-06-01)

Annuncio con qualche giorno di ritardo una nuova minor_release di rog (arrivato a 75 download :-))

Rog (0.1.5) ora e’ in grado di autogenerare i nuovi archivi (mensile e dei tag) necessari ad un nuovo post contestualmente alla sua creazione mediante il comando rake create_post.

E questo grazie alla patch di valvola!!!

Quindi ringrazio lui, domenico e gabriele per rendere questo hack qualcosa di piu’ divertente, perche’ condiviso :-)

---

Rog 0.1.3 - nuovo fantastico logo

(2006-05-17)

Grazie a valvola ora rog ha un vero logo realizzato con mano assai piu’ abile della mia :-)

grazie valvola… ti aspetto come co-mantainer!!!

---

Rog alpha release 0.1.2

(2006-05-16)

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

---

Ha le pinne... chi e'? e' subbaqqui!!!

(2006-05-15)

Chi e’? Cos’e’? :-)

E’ il mio personale /dev/random :-PPP

Il motivo per cui ho deciso di mettere online queste poche pagine html e’ semplice:

sempre piu' spesso ho trovato soluzioni ai problemi che si presentano
durante il lavoro e i miei esperimenti in blog personali di persone 
semplici come noi... jazzisti dell'informazione... 
risolvitori di problemi inesistenti... spingitori di seghe mentali

Quindi cerchero’ di mettere online brevi appunti di esperimenti in corso e quelli portati a termine, soluzioni a bug o malfunzionamenti, idee, progetti etc. etc.

Il blog stesso rappresenta un esperimento in corso: la realizzazione 
di un piccolo tool in ruby frutto dello studio di questa divertente 
tecnologia: Rog

Ruby

Ho incontrato ruby solo poco tempo fa… un giorno un mio amico mi disse:

nicola: Hai mai provato RubyOnRails?

uhm… no… a dire il vero non ho nemmeno mai provato ruby :-(

beh a posteriori direi: Male!!! dovevi provarlo :-)

E’ difficile descrivere la sensazione che si prova a scrivere codice ruby, anzi ancora prima ad imparare a scrivere codice ruby:

continuamente trovi qualche particolare 
  che ti stupisce... 
    eppure ti senti sempre piu' a casa :-)

Ruby.new

Come comincia l’avventura?

ripley@ubik:~$ irb

irb vi spalanchera’ immediatamente le porte di ruby!!!

print "hello, world!"

---