Wallogit.com
2017 © Pedro Peláez
An extension of Parsedown that prevents unwanted white spaces in Japanese.
このエクステンションは、ParsedownのHTML変換処理に以下の振る舞いを追加します:, (*1)
\n)を一定のルールで取り除くこの処理により、日本語(全角文字)で書いたMarkdownの, (*2)
を解消します。, (*3)
例えば、以下のようなMarkdownの可読性をだいなしにする苦肉の策は必要なくなります:, (*4)
以降の動作例を確認してください。, (*5)
Markdown, (*6)
このように日本語で 複数行入力するとき、 改行は空白を意図していません。
Parsedownで変換したHTMLの表示, (*7)
このように日本語で 複数行入力するとき、 改行は空白を意図していません。 ^^^(ここに空白) ^^^(ここにも空白)
「日本語で」と「複数行」の間、「するとき、」と「改行は」の間に空白が入ります。, (*8)
このエクステンションを組み込んで変換したHTMLの表示, (*9)
このように日本語で複数行入力するとき、改行は空白を意図していません。
空白は入りません。, (*10)
ParsedownはHTML変換時、Markdown上の改行を\n(newline)としてそのまま残します。
\nはHTMLで空白として表示されます。, (*11)
この空白は、元々単語を分かち書きする英語など多くの言語では問題になりませんが、 基本的に分かち書きをしない日本語では上記の例のようにちょっと気になるスキマになってしまいます。, (*12)
このエクステンションは、HTML変換時に、意図しない空白の原因になる\nを削除します。, (*13)
これにより、Markdownを日本語で書く場合にも改行位置を気にせず好きなように入力できるようになる利点が得られます。, (*14)
HTML変換時の改行処理条件は以下のとおりです:, (*15)
\nを残す。\nを残す。\nを残す。\nを削除。基本的には全角文字と隣接する改行は、空白を意図したものではないとみなして、削除します。
例外として、単語間の分かち書きを維持すべき文字種の間では、改行は空白を意図しているので、\nをそのまま残します。, (*16)
この改行処理はコードblockには適用しません。, (*17)
なお、Markdown上の改行をHTML上でも改行(<br>)と解釈させたいのであれば、
このエクステンションを使わずにParsedown標準のParsedown::setBreaksEnabled()を使用してください。, (*18)
「全角文字と半角文字の間は必ず空白を開ける」 のような組版ルールに従ってMarkdownを書いている場合は、 改行位置でも一貫性を保つ必要があります。, (*19)
しかし、このExtensionを組み込むと、デフォルト動作では全角文字に隣接する改行を削除するため、, (*20)
全角 ABC 全角
のようなMarkdown("全角 ABC\n全角")の\nも変換後のHTMLでは消えてしまいます。
このHTMLの表示は, (*21)
全角 ABC全角
になり("ABC"の後ろに空白がないため)組版ルールに違反したHTMLになってしまいます。, (*22)
このような特定文字種にスペースを入れる規則を守る必要がある状況では、 以下のメソッドで改行処理ルールを調整することができます:, (*23)
setSingleByteCharsSeparated($bool) -- 半角文字用setSingleByteAlphaSeparated($bool) -- 半角アルファベット用setSingleByteNumericSeparated($bool) -- 半角数字用setSingleByteSymbolSeparated($bool) -- 半角記号用setMultiByteAlphaSeparated($bool) -- 全角アルファベット用setMultiByteNumericSeparated($bool) -- 全角数字用これらのメソッドにtrueを指定することで、各文字種に隣接する改行を削除しなくなります。, (*24)
例えば、setSingleByteCharsSeparated(true)を設定すると、
改行の前後どちらか一方が半角文字であれば、
もう一方が全角文字だとしても\nを残します。
前述の例では改行が削除されなくなり、求めていた表示結果, (*25)
全角 ABC 全角
が得られます。, (*26)
あなたの文書が従う表記規則に一致するように上記メソッドで調整してください。, (*27)
Composer で以下を実行してください。, (*28)
$ composer require noi/parsedown-newline "*" $ composer require erusev/parsedown-extra "*"
または、composer.json に以下の行を含めてください。, (*29)
{
"require": {
"noi/parsedown-newline": "*",
"erusev/parsedown-extra": "*"
}
}
Markdown Extraの拡張記法を使わない場合は、
erusev/parsedown-extraの行は必要ありません。, (*30)
Composerによるパッケージ管理をしていない場合は、include_path のいずれかに
Noi/ ディレクトリを作り、そこへ lib/ 以下のファイルを置いてください。, (*31)
Noi\ParsedownNewline / Noi\ParsedownExtraNewline を使うこれらのクラスは、それぞれParsedownとParsedownExtraに本エクステンションを組み込んだ実装クラスです。, (*32)
そのままnewして使うか、さらに派生クラスを定義して他のエクステンションを組み込んで使用してください。, (*33)
<?php
$pd = new \Noi\ParsedownNewline(); // or new \Noi\ParsedownExtraNewline();
echo $pd->text("Parsedownは\nとても\n便利");
// Output:
Parsedownはとても便利, (*34)
Parsedown派生クラスに組み込むあなた独自のParsedown派生クラスがある場合は、本エクステンションのtraitを組み込んでください。, (*35)
以下のようにNoi\Parsedown\JapaneseNewlineTraitをuseします:, (*36)
<?php
class YourParsedown extends \Parsedown /* or \ParsedownExtra or etc. */ {
use \Noi\Parsedown\JapaneseNewlineTrait;
//...
}
注意, (*37)
以下の条件を片方でも満たす場合はuseだけで組み込むことができません:, (*38)
YourParsedown)でunmarkedText()が再定義されているuseする他のtraitにunmarkedText()が定義されている1の場合、本ExtensionのunmarkedText()が上書きされるため有効になりません。
2の場合、メソッド名の衝突エラーが発生します。, (*39)
これらを解決するためには競合回避コードが必要です。 使い方3を確認してください。, (*40)
本ExtensionのtraitはunmarkedText()をoverrideします。, (*41)
同時にuseする他のtraitでもunmarkedText()が定義されている場合、
メソッド名の衝突エラーが発生してしまうため、そのままでは組み込むことができません。
これを解決するための競合回避コードを書く必要があります。, (*42)
組み込み先クラスを以下のように定義してください:, (*43)
<?php
use Noi\Parsedown\JapaneseNewlineTrait;
use AnotherExtensionTrait;
class YourSuperDuperParsedown extends ... {
// 1. 競合Extension側のunmarkedText()に別名を付ける
use JapaneseNewlineTrait, AnotherExtensionTrait {
AnotherExtensionTrait::unmarkedText as unmarkedText_Another;
}
// 2. 実装クラスにunmarkedText()を定義
protected function unmarkedText($text) {
// 3. unmarkedText()の中で、競合Extension側のunmarkedText()を別名で呼ぶ
$text = $this->unmarkedText_Another($text);
// 4. 3の結果をunmarkedJapaneseNewline()の引数に渡す
return $this->unmarkedJapaneseNewline($text);
}
}
要点は、実装クラスのunmarkedText()内で, (*44)
unmarkedText()を別名で実行することJapaneseNewlineTrait::unmarkedJapaneseNewline()を実行することです。, (*45)
MITライセンスです。ライセンスの制限の範囲内であれば商用・非商用を問わず自由にお使いください。, (*46)
Code released under the MIT License - see the LICENSE file for details., (*47)
An extension of Parsedown that prevents unwanted white spaces in Japanese.
MIT
parser extension library markdown parsedown japanese newline line break white space
An extension of Parsedown that prevents unwanted white spaces in Japanese.
MIT
parser extension library markdown parsedown japanese newline line break white space