i18n.site MarkDown 撰寫約定

錨點

傳統MarkDown的錨點基于文本內容來生成，在多語言的情況下，此方案不可行。

i18n.site約定的錨點方案是，在MarkDown中插入類似<a rel=id href="#xxx" id="xxx"></a>的文本，來手動創建定位錨點。

<a rel=id href="#xxx" id="xxx"></a>，這里rel=id定義了錨點的頁面樣式，xxx請替換為你實際的錨點英文縮寫。

錨點通常加在標題里，如:

### <a rel=id href="#i18" id="i18"></a>i18 : MarkDown Command Line Translation Tool

顯示效果如下:

在MarkDown中寫HTML

pug代碼中可以嵌入HTML。

<pre>元素中的內容不會被翻譯。

結合這兩點，可以很方便的在MarkDown中寫HTML，來實現各種顯示效果。

點此參考 i18n.site 首頁的語言代碼列表 HTML 編寫，代碼如下:

<h1 style="display:flex;justify-content:space-between">i18n.site ⋅ International Solutions<img src="//p.3ti.site/logo.svg" style="user-select:none;margin-top:-1px;width:42px"></h1>
<pre class="langli" style="display:flex;flex-wrap:wrap;background:transparent;border:1px solid #eee;font-size:12px;box-shadow:0 0 3px inset #eee;padding:12px 5px 4px 12px;justify-content:space-between;"><style>pre.langli i{font-weight:300;font-family:s;margin-right:2px;margin-bottom:8px;font-style:normal;color:#666;border-bottom:1px dashed #ccc;}</style><i>English</i><i>簡體中文</i><i>Deutsch</i> … …</pre>

注意，上文<pre>中還定義了<style>。