This is a patched version of Fossil with enhanced Markdown features.
See README.fossmd.md for all gory details, thoughts and plans for this project.
Features
Feature: ToC
Generate ToC automatically (or manually) on each Markdown (and Wiki) page.
See README.fossil-fossmd.toc.md for ToC details.
See README.fossil-fossmd.toc.longlong.md for the long long ToC story (useless for most readers).
Test ToC feature:
fossil test-markdown-render toc-test.md ./fossil-fossmd test-markdown-render toc-test.md
Feature: Fenced Code Block (FCB)
Support for the non-standard (but widely supported) multiline code block, a.k.a. Fenced Code Block (FCB), starting with ``` (or ~~~).
See README.fossil-fossmd.fcb.md for FCB details.
Test FCB feature:
fossil test-markdown-render fcb-test.md ./fossil-fossmd test-markdown-render fcb-test.md
Feature: Fenced code block with Info String (for syntax highlighting etc.)
Feature: Transclusion
Feature: Transclusion of Markdown files and/or Fossil artifacts
Feature: Combine Fenced code block with Info String and Transclusion (to syntax highlight an included file or artifact)
Feature: Combine Fenced code block with custom Info String and Transclusion (to include any kind of file, to render any kind of content)
Feature: Split/single page (usually in Abstract section, just before ToC)
NOTES (about this software in particular, but not in any particular order)
Test a bug here.
Test a bug ` ` here.
This bug has now been fixed in Fossil
Test Markdown rendering from command-line, with Fossil and with FossMD, respectively:
fossil test-markdown-render README.fossil-fossmd.md ./fossil-fossmd test-markdown-render README.fossil-fossmd.md
Makefile
Update the Makefile after editing
src/makemake.tcl
:make makemake
Update the Fossil version after merging new changes from
../fossil
:cp ../fossil/manifest.uuid manifest_fossil.uuid; cp ../fossil/manifest manifest_fossil; cp ../fossil/VERSION VERSION_FOSSIL
To check if our copy of Fossil's manifest and VERSION is up-to-date:
make cmpversion
TODO: make cmpversion
doesn't work on FreeBSD.
Some CSS and JavaScript, which should be rendered for .md
but not for .wiki
:
This is red
Valgrind
valgrind -v --track-origins=yes --leak-check=yes ffmd test-markdown-render toc-test.md
valgrind -v --track-origins=yes --leak-check=full fossil test-markdown-render minimal.md
Valgrind: Existing Fossil web page
valgrind -v --track-origins=yes --leak-check=yes ffmd test-markdown-render www/webpage-ex.md