<<code>> マクロ

構文

<<code [lang=name] [inline={true|false}] [indent=L] [wrap={true|false}]>>
ここにコードを記述します
<</code>>

• name をコードの言語名に置き換えてください。 有効な言語名については、後述の シンタックスハイライト可能な言語一覧 を参照してください。
• indent について、L を字下げレベル (1〜4) に置き換えてください。 (リスト の余白の大きさと対応しています)
• wrap を指定すると、行を折り返すかどうか制御できます。既定では、コードブロックをスクロールするようになっています。

概要

<<code>> マクロを利用すると、記事中にソースコードを記載できます。

簡単な例:

<<code>>
from reversion.models import Revision
from .helpers import ProcessedContent
class Node(models.Model):
    language = models.CharField(max_length=10, default='en-us')
<</code>>

……以上は次のように表示されます:

from reversion.models import Revision
from .helpers import ProcessedContent
class Node(models.Model):
    language = models.CharField(max_length=10, default='en-us')

折り返しとスクロールの違い

<<code wrap=false>>
if self.is_image:
    return reverse('nodes:image', kwargs={'slug': self.node.slug, 'image_slug': self.slug, 'language': self.node.language})
else:
    return reverse('nodes:attachment', kwargs={'slug': self.node.slug, 'attachment_slug': self.slug, 'language': self.node.language})
<</code>>

……以上は次のように表示されます:

if self.is_image:
    return reverse('nodes:image', kwargs={'slug': self.node.slug, 'image_slug': self.slug, 'language': self.node.language})
else:
    return reverse('nodes:attachment', kwargs={'slug': self.node.slug, 'attachment_slug': self.slug, 'language': self.node.language})

<<code wrap=true>>
if self.is_image:
    return reverse('nodes:image', kwargs={'slug': self.node.slug, 'image_slug': self.slug, 'language': self.node.language})
else:
    return reverse('nodes:attachment', kwargs={'slug': self.node.slug, 'attachment_slug': self.slug, 'language': self.node.language})
<</code>>

……以上は次のように表示されます:

if self.is_image:
    return reverse('nodes:image', kwargs={'slug': self.node.slug, 'image_slug': self.slug, 'language': self.node.language})
else:
    return reverse('nodes:attachment', kwargs={'slug': self.node.slug, 'attachment_slug': self.slug, 'language': self.node.language})

<<code>> とリンク

<<code>> マクロとリンクは相性が悪いので、行中のコードにリンクを張りたい場合は ##...## を使用してください。

例えば、[[insert|<<code>>INSERT<</code>>]] や <<code>>[[insert|INSERT]]<</code>> の代わりに、次のように記述します。

##[[insert|INSERT]]##

<<code>> とリスト

コードブロックをリスト項目の中に入れたい場合、特にコードブロックの後で番号付けを再開したい場合は、リスト項目内のテキストと同じ行に、コードブロックの最初の行を記述しなければなりません。(おそらく inline=false を指定する必要がありますが、構文解析器の新しいバージョンなどではこの問題に対処できる可能性があります。わからない場合は両方を試してみてください。)

例:

# その一
# その二<<code inline=false>>int main(void) {
    return;
}
<</code>>
# その三

1. その一
2. その二

   int main(void) {
       return;
   }
   

3. その三

シンタックスハイライト

<<code>> マクロでシンタックスハイライトも可能です。

次のようにして、上記の Python の例をシンタックスハイライトさせることができます。

<<code lang=python>>
from reversion.models import Revision
from .helpers import ProcessedContent
class Node(models.Model):
    language = models.CharField(max_length=10, default='en-us')
<</code>>

from reversion.models import Revision
from .helpers import ProcessedContent
class Node(models.Model):
    language = models.CharField(max_length=10, default='en-us')

インラインレベルとブロックレベル

lang= 属性が付いた <<code>> マクロを使用している場合、コードを行中に配置するか、ブロックレベルで表示するか指定することができます。 (inline 属性が指定されていない場合、Creole パーサーは適切な値を推測しようとします。)

有効な値は true と false です。

これは <<code lang=c inline=true>>inline=true のコード<</code>> です。

これは inline=true のコード です。

これは <<code lang=c inline=false>>inline=false のコード<</code>> です。

これは

inline=false のコード

です。

これは <<code lang=c inline=none>>inline=none のコード<</code>> です。

これは

inline=none のコード

です。

シンタックスハイライト可能な言語一覧

書式設定

コードブロック中で Creole の書式設定を使うには、<<creole>> 〜 <</creole>> タグを使用します。

例:

<<code>>
コード <<creole>>//イタリック体に//<</creole>>
他のコード <<creole>>**太字に**<</creole>>
さらに他のコード
<</code>>

次のように表示されます:

コード イタリック体に
他のコード 太字に
さらに他のコード

開始タグと終了タグは、同じ行に記述する必要があります。