folkert/import-style-guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
15 Commits 5 Branches 0 Tags 97 KiB
Ada 79.4%
Shell 18.4%
MDX 2.2%
384443692c
Go to file
Folkert Kevelam 384443692c Add an initial solution to the parsing of definition lists for MDX 
MDX does not follow the 'standard' way of parsing defintion lists.
Instead, this commit adds a small filter that basically hacks some
html tags to the source definition list.
2025-06-07 19:41:37 +02:00
data Import initial sources 2022-09-10 10:47:13 +03:00
gnat Import initial sources 2022-09-10 10:47:13 +03:00
source Add an initial solution to the parsing of definition lists for MDX 2025-06-07 19:41:37 +02:00
.gitignore Import initial sources 2022-09-10 10:47:13 +03:00
2wiki.sh Split long sections into subdirectories. 2023-04-21 14:19:07 +03:00
alire.toml Import initial sources 2022-09-10 10:47:13 +03:00
fetch.sh Add options for multi column code examples (#8) 2025-05-31 13:59:57 +03:00
LICENSE Initial commit 2022-09-10 10:32:14 +03:00
note.mdx Add an empty line before :::note admonitions 2022-09-26 13:49:31 +03:00
README.md Rewrite to work with pandoc-3.1.3 2025-05-12 23:24:18 +03:00

README.md

Scripts to fetch Ada Quality and Style Guide wikibook

These scripts convert the WiKi book to ada-lang.io markdown.

Requirements

You need pandoc-3.1.3, curl, sed installed.

Build and run

Build a pandoc filter with Alire:

alr build

Then run:

./fetch.sh <OUTPUT_DIR>

Then run yarn format in ada-lang.io repository to reformat output according to Docusaurus style.

To be fixed

  • Arrange code blocks in Source Code Presentation in two columns
  • Add chapter/section numbers
  • Replace "see Guideline X.Y.Z{,/and X.Y.Z}", "Chapter X", "Sections X.Y" with cross links
  • change definition lists? (in Portability, OOP)
  • Fix Wikipedia links
  • Fix examples in Reusability: "Compare the body for the simplest version"
  • Fix ACES in References
  • Fix Bibliography