Cytowanie kodu w artykułach |
Wpisany przez Jan Jackowicz-Korczyński | |||
niedziela, 20 września 2009 08:06 | |||
Aby korzystnie cytować kod jakiegokolwiek programu czy skryptu dobrze jest zainstalować odpowiednie dodatki do systemu. Działają one niezależnie od zastosowanego edytora HTML. Takich dodatków jest sporo - można je odnaleść w repozytorium Joomla Extension Directory: http://extensions.joomla.org/. W naszym serwisze zainstalowano dodatek: codecitation autorstwa Konstantina Nizhegorodova z wykorzystaniem silnika skryptu opracowanego przez Alexa Gorbaczowa.
Podświetla on składnię natępujących języków i skryptów: ActionScript3, Bash / shell, C #, C + +, CSS, Delphi, Diff, Groovy, JavaScript, Java, JavaFX, Perl, PHP, zwykły tekst, PowerShell, Python, Ruby, Scala, SQL, Visual Basic, XML, HTML , XSLT. Aby go zastosować w artykule należy tekst cytowanego skryptu poprzedzić znacznikiem: {codecitation} a zakończyć znacznikiem: {/codecitation}. Dodatek uruchamia dopiero podświetlanie składni w podglądzie artykułu. Edytor wyświetla tylko znaczniki. Dodatek oprócz wyświetlenia ponumerowanych linii kodu udostepnia narzędzia (najedź myszką na prawy róg kodu) pokazania kodu, jego umieszczenia w schowku windows, oraz drukowania. Przykład wyświetlania sktyptu php: W edytorze, podczas tworzenia artykułu widoczny będzie taki kod:
{codecitation class='brush: php'}<?php
|
Komentarze
Aby ich uniknąć należy cały kod - od <pre>{codecitatio n} do {/codecitation}</pre>
objąć w znacznik <pre /> lub wybierając "tryb formatowany" w edytorze.
[codecitation class='brush:php']
function funkcjaPHP() {}
[/codecitation]
(trzeba wstawiać klamry {} w miejsce nawiasów kwadratowych []).