source: spip-zone/_plugins_/coloration_code/branches/v0.3/plugin.xml @ 84314

Last change on this file since 84314 was 84314, checked in by spip.franck@…, 5 years ago

Ce n'est plus spip-contrib, mais contrib.spip

File size: 4.3 KB
Line 
1<plugin>
2        <nom>
3          <multi>
4                [fr]Coloration Code
5                [en]Code higlighting
6                [it]Colorazione del codice
7                </multi>
8        </nom>
9        <slogan>
10                <multi>
11                [fr]Coloration syntaxique du code source dans les articles
12                [en]Syntax higlighting of code placed in articles
13                [it]Colorazione sintattica del codice utilizzato nel testo
14                </multi>
15        </slogan>
16        <auteur>Pierre Andrews (Mortimer) - ARNO*</auteur>
17        <version>0.3.0</version>
18        <etat>stable</etat>
19        <lien>http://contrib.spip.net/Coloration-Code</lien>
20        <slogan>
21                <multi>
22                [fr]Coloration syntaxique du code source dans les articles
23                [en]Syntax higlighting of code placed in articles
24                [it]Colorazione sintattica del codice utilizzato nel testo
25                </multi>
26        </slogan>
27        <description>
28        <multi>
29        [fr]
30Il suffit de mettre le code entre
31_ {{&lt;code class="langage"&gt;...&lt;/code&gt;}}
32_ ou avec un cadre
33_ {{&lt;cadre class="langage"&gt;...&lt;/cadre&gt;}}.
34
35Les langages support&#233;s sont ceux fournis par [->http://sourceforge.net/projects/geshi/] avec une classe supplementaire: "spip".
36
37
38Par d&#233;faut, si le code mis en surbrillance fait plus d'une ligne, il est mis en cache sous forme textuelle et propos&#233; au t&#233;l&#233;chargement. Ce fonctionnement est control&#233; globalement par une constante PLUGIN_COLORATION_CODE_TELECHARGE d&#233;faut true. Il peut &#234;tre forc&#233; localement en rajoutant la classe "sans_telechargement" dans un sens ou "chargement" dans l'autre comme
39_ {{&lt;code class="php sans_telechargement"&gt;}}
40
41Vous pouvez aussi utiliser le filtre {coloration_code_color} dans un squelette comme
42_ <code>#TEXTE**|coloration_code_color{spip,code}</code> : colore #TEXTE avec le language spip en format code (sans cadre), voir exemple lecode.html. L'url depuis l'article serait <code>#URL_SITE_SPIP/spip.php?page=lecode&id_article=#ENV{id_article}</code>
43
44          [en]
45You just have to put it between the tags:
46_ {{&lt;code class="language"&gt;...&lt;/code&gt;}}
47_ or with a frame
48_ {{&lt;cadre class="langage"&gt;...&lt;/cadre&gt;}}.
49
50The possible languages are the ones supported by [->http://sourceforge.net/projects/geshi/] with an extra class: "spip".
51
52
53By default, when the highlighted code has more than one line, il will be put in cache as text and proposed to upload. This feature may be controlled globaly through the constant PLUGIN_COLORATION_CODE_TELECHARGE default true. It may also be forced locally by adding a class "sans_telechargement" in a way or "chargement" in the other as
54_ {{&lt;code class="php sans_telechargement"&gt;}}
55
56You may also use {coloration_code_color} as a filter in a squelette as
57_ <code>#TEXTE**|coloration_code_color{spip,code}</code>: highlights #TEXTE with langage "spip" in format code (without frame), see example lecode.html. From article url would be <code>#URL_SITE_SPIP/spip.php?page=lecode&id_article=#ENV{id_article}</code>
58
59        [it]
60Dovete solo utilizzare il segnaposto:
61_ {{&lt;code class="linguaggio"&gt;...&lt;/code&gt;}}
62_ o con riquadro
63_ {{&lt;cadre class="linguaggio"&gt;...&lt;/cadre&gt;}}
64
65Sono supportati tutti i linguaggi di [->http://sourceforge.net/projects/geshi/] ed in aggiunta la classe "spip".
66
67In maniera predefinita, Se il codice da colorare ha pi&#249; di una linea, sar&#224; salvato in cache sotto forma di testo semplice e disponibile per lo scaricamento. Questa impostazione pu&#242; essere modificata globalmente grazie alla costante PLUGIN_COLORATION_CODE_TELECHARGE, che normalmente &#232; impostata a true. Quest'ultima pu&#242; anche essere modificata localmente aggiugendo la classe "sans_telechargement" o "chargement", es:
68_ {{&lt;code class="php sans_telechargement"&gt;}}
69
70_ Potete utilizzare {coloration_code_color} anche come un filtro in scheletro in questo modo:
71_ <code>#TEXTE**|coloration_code_color{spip,code}</code>: colora #TEXTE con le regole del linguaggio "spip" in formato code (senza il riquadro), vedi l'esempio lecode.html. L'url per vedere il codice dell'articolo dalla sua stessa pagina sar&aacute;: <code>#URL_SITE_SPIP/spip.php?page=lecode&id_article=#ENV{id_article}</code>
72          </multi>
73        </description>
74   <options>mes_options.php</options>
75        <prefix>coloration_code</prefix>
76        <pipeline>
77                <nom>pre_typo</nom>
78                <action>echappe</action>
79                <inclure>coloration_code.php</inclure>
80        </pipeline>
81        <necessite id="SPIP" version="[1.9.0;1.9.2]" />
82        <categorie>edition</categorie>
83</plugin>
Note: See TracBrowser for help on using the repository browser.