コンテンツにスキップ

執筆ガイド

1つの演習は、問題、ヒント、解答の3ファイルで管理します。

  • docs/problems/NNN-slug.md
  • docs/hints/NNN-slug.md
  • docs/solutions/NNN-slug.md

NNN は3桁の通し番号、slug は英小文字とハイフンで表す短い名前です。 たとえば 001-even-or-odd の場合、問題・ヒント・解答で同じファイル名を使います。 難易度は front matter の difficulty に1から5の整数で書き、本文では の数で表示します。問題・ヒント・解答では同じ値を使います。 が多いほど難しい演習です。

新しい演習を書くときは、リポジトリ直下の templates/ にある3つのMarkdownファイルを複製して使います。

記述方針

  • 問題ページでは、解き方を先に明かさず、入力、出力、制約、例を明確にします。
  • ヒントページでは、段階的なヒントを書きます。最後のヒントだけ、解法の輪郭に踏み込みます。
  • 解答ページでは、方針、実装、確認、発展を分けます。
  • すべてのページの冒頭に、対応する問題・ヒント・解答へのリンクを置きます。
  • 難易度表記は、冒頭リンクの直後に **難易度:** ☆ の形で置きます。

数式

インライン数式は \(n \bmod 2\)、別行の数式は次のように書きます。

\[
a_n = a_{n-1} + a_{n-2}
\]