執筆ガイド¶
1つの演習は、問題、ヒント、解答の3ファイルで管理します。
docs/problems/NNN-slug.mddocs/hints/NNN-slug.mddocs/solutions/NNN-slug.md
NNN は3桁の通し番号、slug は英小文字とハイフンで表す短い名前です。
たとえば 001-even-or-odd の場合、問題・ヒント・解答で同じファイル名を使います。
難易度は front matter の difficulty に1から5の整数で書き、本文では ☆ の数で表示します。問題・ヒント・解答では同じ値を使います。
☆ が多いほど難しい演習です。
新しい演習を書くときは、リポジトリ直下の templates/ にある3つのMarkdownファイルを複製して使います。
記述方針¶
- 問題ページでは、解き方を先に明かさず、入力、出力、制約、例を明確にします。
- ヒントページでは、段階的なヒントを書きます。最後のヒントだけ、解法の輪郭に踏み込みます。
- 解答ページでは、方針、実装、確認、発展を分けます。
- すべてのページの冒頭に、対応する問題・ヒント・解答へのリンクを置きます。
- 難易度表記は、冒頭リンクの直後に
**難易度:** ☆の形で置きます。
数式¶
インライン数式は \(n \bmod 2\)、別行の数式は次のように書きます。