Explore: Go templates for includes and page manipulation
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
Research direction
Start with MdToConfluence and the current comment-directive string substitutions for confluence-toc and markfluence-version. Trace where expansion could fit relative to parsing and raw storage passthrough, then assess includes, variables, conditionals, security, and authoring/API concerns. Done means a design proposal addressing the listed trade-offs.
Written by the indexing model from the issue text.
Description
Investigate using Go templates (text/template) for markdown includes, reusable snippets, and page manipulation.
This generalizes the current comment-directive tokens (<!-- confluence-toc -->, <!-- markfluence-version -->), which were added as simple string substitutions inside MdToConfluence with the intent to revisit as templates.
Explore:
- What templating buys (includes, variables like version/date, conditionals).
- Where it fits in the convert pipeline (pre-parse expansion vs. token substitution).
- Security (template injection, file includes escaping the docs tree).
- API/authoring design and how it interacts with raw storage passthrough.
Deliverable: a design proposal.
- Dominant language
- Go
- Stars
- 2
- Forks
- 0
- Avg merge
- 2h 5m
- Merged PRs (30d)
- 50
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from mozilla/markfluence
-
bug
Difficulty 3/5 1-2 days Newbie friendliness 55/100
mozilla/markfluence#181 · 1 comment ·
-
polish the prose Open
Difficulty 3/5 1-2 days Newbie friendliness 68/100
mozilla/markfluence#165 ·
-
bug
Difficulty 5/5 Over a week Newbie friendliness 48/100
mozilla/markfluence#163 ·
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 25/100
mozilla/markfluence#162 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 48/100
mozilla/markfluence#157 ·
All issues in mozilla/markfluence
Similar issues
-
kind/bug needs-triage
Difficulty 1/5 Under an hour Newbie friendliness 72/100
matrixorigin/matrixone#29223 ·
-
needs-acceptance wg/data-plane-networking
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
vllm-project/semantic-router#4024 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
alexgorbatchev/dotfiles#107 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 84/100