Edytor w WordPressie (oczywiście nie mówię o WYSIWYG) może i jest fajny, ale niewystarczający. Zupełnie nie wiem, dlaczego tag strong jest oznaczony w nim jako pogrubienie, a em jako kursywa – jest to błąd semantyczny (Riddle o tym pisał). Nie posiada on też m. in. przycisków do wstawiania tagów h2 czy h3, które przecież często widzi się na blogach. Można go co prawda dopakować wtyczkami takimi jak AddQuicktag, ale nadal będziesz musiał przechodzić ‘koszmar’ w postaci wstawiania tagów HTML. Dlatego wymyślono alternatywne języki znaczników (z ang. markup languages).

Markup powah

Markdown, Textile czy BBCode to jedne z popularniejszych języków. Zdecydowana większość (o ile nie wszystkie) silników for posiada wbudowaną obsługę BBCode – są to te wszystkie znaczniki typu [b] czy [url]. Na forach stosowane są tylko przez poweruserów, reszta jest zbyt leniwa, żeby z nich korzystać. Jego zaletą jest to, że łatwo go przyswoić osobom, które wcześniej miały kontakt z HTML-em. Wadą jest to, że nadal musimy wklepać równie dużą ilość znaków. Dla przykładu:

<b>Pogrubienie w HTML-u</b>
[b]Pogrubienie w BBCode[/b]

Tutaj i tutaj po siedem znaków. Nie uważajcie mnie za jakiegoś purystę “znacznikowego”, po prostu im mniej znaków, tym lepiej.

O wiele lepiej od BBCode prezentuje się Markdown i Textile. Ten drugi jest znany pewnie użytkownikom Joggera^[2]. Markdown jest mniej znany, ale moim zdaniem jest nieco lepszy. Oba jednak są lepszym wyjściem niż wklepywanie surowego HTML-a. Dlaczego?

<a href="http://google.pl/">Link w HTML-u</a>
[Link w Markdown](http://google.pl/)

Piętnaście znaków versus cztery. Robi różnicę, prawda? Jeszcze jeden przykład:

<blockquote>Cytat blokowy w HTML-u.</blockquote>

> Cytat blokowy w Markdown!

<ul>
<li>lista wypunktowana</li>
<li>w HTML-u</li>
</ul>

- lista wypunktowana
- w Markdown

Taa, Markdown z Textile miażdżą HTML-a niczym III Rzesza wraz z… Odpuśćmy to porównanie.

Dobrze, oba języki wyglądają nieźle. Ale bez odpowiedniego preprocesora, który przetłumaczy Markdown czy Textile na HTML nic nie zrobimy.

Ruby powah

Pogrzebałem trochę na userscripts.org i oficjalnym repozytorium dla wordpressowych wtyczek, ale wtyczki po prostu nie były kompatybilne z nowszymi wersjami WP, a skrypty w JS… Cóż, nie, to też nie było to.

Pomyślałem wtedy “Uczysz się Ruby, napisz swojego gema”^[3]. Nie sprawdzając, czy istnieje już coś takiego, przystąpiłem do realizacji własnych założeń. Po prostu w ramach nauki.

Wiedziałem o istnieniu dwóch, całkiem fajnych preprocesorów napisanych w Ruby: RedCloth dla Textile oraz BlueCloth dla Markdown. Żeby powiększyć ilość opcji programu, dodałem trzeci, znaleziony na GitHubie bb-ruby dla… Tak, BBCode.

ClothMark

I tak powstał ClothMark. Wzbogaca on Twoją konsolę/terminal o jedną, milutką komendę: clothmark.

Jak zainstalować to cacko?

Userzy Linuksa i Maka sobie poradzą, zawsze trzeba jednak pomóc użytkownikom Windowsa.

• Najpierw instalujesz inne przydatne narzędzie, które zwie się RubyInstaller. Jeśli podczas instalacji wyskoczy jakiekolwiek pytanie o instalację RubyGems – zainstaluj, bo to też będzie Tobie potrzebne.

• Jeśli jesteś dumnym użytkownikiem Linuksa lub Maka i nadal jesteś matołem^[4], który nie wie, jak instalować rzeczy w jego systemie – przeczytaj instrukcję z oficjalnej strony.

• Załóżmy, że już uporałeś się z instalacją Ruby. Teraz wchodzisz do swojej konsoli/terminalu i wklepujesz następujące komendy (dodaj sudo przed drugą komendą, jeśli używasz Uniksa):

gem sources -a http://gems.github.com
gem install ravicious-clothmark

To już koniec, pod Windowsem powinieneś zobaczyć podobne informacje, jak na screenie:

Jak używać tego cacka?

Proste. Wchodzisz do katalogu z Twoim plikiem, którego treść napisana jest w Markdown i wklepujesz następującą komendę:

clothmark nowy_post_w_markdown.txt

I tyle. Twój plik zostanie zapisany pod nazwą nowy_post_w_markdown.html.

Ale… Nie chcesz Markdown? Jednak wolisz Textile lub BBCode? Proszę bardzo:

clothmark textile_rulez --markup textile
clothmark bbcode_rox --markup bbcode

Później już tylko wklejasz źródło wygenerowanego pliku do, na przykład, wordpressowego edytora i gotowe.

Właśnie, wpis możesz napisać w Twoim ulubionym edytorze i po prostu zapisać go jako osobny plik. Ja ten wpis popełniłem w WriteMonkey.

O reszcie opcji przeczytasz w readme. Ja chciałbym pokazać jedną, która może być przydatna.

Otóż domyślnie wygenerowany plik nie jest ostylowany. Jest po prostu tym, co napisałeś w Markdown/Textile/BBCode, ale w HTML-u. Jeśli chciałbyś dodać styl CSS i dodatkowy kod HTML, to dodaj do komendy parametr -ah lub --additional-html, wtedy plik powinien wyglądać lepiej.

Wiem, że kilka rzeczy wymaga pewnej poprawy, przede wszystkim mój angielski i przechwytywanie wyjątku, kiedy plik wejściowy nie istnieje, więc zgłaszajcie wszystkie znalezione błędy (i ewentualne propozycje) ;-)

1. Pewnie wiecie, co to jest, ale wolę się upewnić.
2. Sam kiedyś krytykowałem Joggera za Textile, ale wtedy byłem mały i głupi.
3. gem to po prostu dodatkowa biblioteka lub program
4. Ironia, ironia!

Największą bolączką Railsów jest brak taniego (a najlepiej całkowicie darmowego), ale w miarę funkcjonalnego hostingu, na którym raczkujący programiści mogliby stawiać swoje pierwsze aplikacje. Owszem, istnieje prześwietne (jeśli chodzi o wdrożenie aplikacji) Heroku, ale żeby mieć dostęp nawet do darmowych ficzerów, należy podać numer karty kredytowej, a ową kartę nie każdy posiada. Dzięki temu nie można podpiąć własnej domeny pod projekt czy dodać zadań do crona.

Koderzy PHP nie mają w ogóle problemów, jeśli chodzi o hosting, koderzy Pythona mają darmowe Google App Engine, które wspiera także Javę.

Javę, Javę… Właśnie, Ruby posiada swoją implementację w Javie, ale postawienie railsowej aplikacji na GAE to kupa roboty. Z Sinatrą jest nieco mniej problemów.

Z jednej strony jest Heroku, z drugiej chciałoby się czegoś więcej. Niestety, na razie na pisaniu aplikacji nie zarabiam, więc nie stać mnie na najtańszą ofertę na MegiTeam (170 zł na rok). A może znacie w miarę tani hosting, który powinien zaspokoić potrzeby użytkownika Heroku?

Wątpię w uruchomienie przez Google hostingu dla RoR, bo całe Google stoi na Pythonie, dlaczego więc mieliby zajmować się obcą technologią? Pomimo tego, niech usłyszą mój niemy krzyk: Google, daj mi hosting dla Ruby on Rails!

Blue Sky on Rails by ecstaticist

Aż tyle? Tak, ale każda strona tego poradnika to świetnie wykonana ilustracja. Po raz pierwszy widzę tak przezabawnie wykonany tutorial.

Nieważne, czy piszesz w Ruby, czy w innym języku, jeśli jesteś geekiem i chcesz się pośmiać, to ten poradnik jest dla Ciebie ;-)