Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

feat: shortcodes from template files

クローズ
#36 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
csharp, markdown
領域
content, tooling

調査の方向性

Start with Fanstatic/Parsers/RefShortcodeParser.cs and the processing path in Page.cs:429, then inspect the existing shortcode tests in Fanstatic.Test/ and fixture sites in .TestSites/. Run ./build.sh test before changing behavior. Done means site and theme shortcode resolution, paired and Markdown-rendered forms, contextual parameters, clear unknown-shortcode errors, documentation examples, and passing ref/relref tests with the stated coverage and CRAP limits.

索引モデルが issue の本文から書いたものです。

説明

c:templates p:high size:M t:feature

Part of the Phase 3 epic (#33).

Current State

Only ref/relref shortcodes exist, hard-coded in Fanstatic/Parsers/RefShortcodeParser.cs, processed on raw
Markdown before Markdig (Page.cs:429).

Tasks:
  • Generalize the parser: {{< name arg1 key="v" >}} and paired {{< name >}}inner{{< /name >}}
  • Resolve shortcodes/<name>.html (site → theme); keep ref/relref as built-ins
  • Context: shortcode.Params (positional and named), shortcode.Inner, shortcode.Name, page, site
  • {{% name %}} form whose output is Markdown-rendered (Hugo semantics)
  • Unknown shortcode: clear error with page path and line
  • Docs page with examples

Tests live in Fanstatic.Test/ (xUnit + NSubstitute); fixture sites in .TestSites/. Run ./build.sh test; new/changed methods need CRAP ≤ 15 and ≥ 75 % line coverage.

Acceptance Criteria:
  • Fixture site with a youtube shortcode and a paired note shortcode renders correctly.
  • Existing ref/relref tests still pass.
Related:
  • #33 (Phase 3 epic, parent)
主要言語
C#
スター
1
フォーク
0
平均マージ
8時間 19分
マージ済み PR(30日)
5

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

MASS4ORG/Fanstatic のほかの issue

MASS4ORG/Fanstatic の issue をすべて見る

似ている issue

C# の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。