AsciiDoc で日本語原稿を書く際の留意点

AsciiDoc はマークアップを地の文と区別するためにマークアップの前後に空白を入れる必要があります.そうした空白を削除するツールも存在します.ここでは,そうしたツールに頼らずに余分な空白を入れないようにする方法をまとめておきます.この投稿は4年前に書いたHugo で AsciiDoc 原稿を書く際の留意点の補足でもあります. マークアップの前後の空白 AsciiDoc は, DocBook に比べマークアップの手間が省ける分,地のテキストとコマンドを分離するマーク .... »

Hugoのサマリ長(Summary Length)

Hugoではトップページの投稿一覧に表示するサマリの長さがデフォルトで70でした.英語の場合は70単語で良いのですが,日本語では70文字になってしまい圧倒的に少なすぎました.先日ようやく最新のMasterにデフォルトのサマリ長を変更するコードがマージされました. Make SummayLength configurable #3735 Change SummaryLength to be configurable #3924 リポジトリから最新バージョンをビルド,インストールし,config.toml に summaryLength = 200 と指定することで,デフォルトのサマ .... »

Hugo で AsciiDoc 原稿を書く際の留意点

Hugo は静的にWebサイトを生成するプログラムです.データベースを使って動的にページを生成するCMSと違い,ローカルに作成された全原稿から予めサイト全体のページを生成します.カテゴリやタグのページも静的に生成されます.このサイトも Hugo で作成しています. 原稿ファイルをHTMLに変換するのは Hugo ではなく Hugo が起動する外部プログラムです. Supported Content Formats にサポートする原稿のフォーマットが載っています.拡張されたMarkdo .... »