ralsina/shortcode
1
0
Fork 0
Code Pull Requests Activity
A library to parse shortcodes as used in Hugo and Nikola
45 Commits 1 Branch 0 Tags 235 KiB
C 88.1%
Crystal 8.2%
Ragel 3.6%
Makefile 0.1%
9bdbff68fb
Go to file
Roberto Alsina 9bdbff68fb license
2023-07-14 10:04:01 -03:00
.vscode meh 2023-07-12 17:30:41 -03:00
spec start crystal side of things 2023-07-14 10:03:51 -03:00
src start crystal side of things 2023-07-14 10:03:51 -03:00
.gitignore return errors from parse() 2023-07-13 22:05:11 -03:00
LICENSE license 2023-07-14 10:04:01 -03:00
Makefile return errors from parse() 2023-07-13 22:05:11 -03:00
README.md README.md 2023-07-11 22:25:57 -03:00
shard.yml start crystal side of things 2023-07-14 10:03:51 -03:00
shortcodes.h return errors from parse() 2023-07-13 22:05:11 -03:00
shortcodes.rl return errors from parse() 2023-07-13 22:05:11 -03:00
tests.c return errors from parse() 2023-07-13 22:05:11 -03:00
TODO.md return errors from parse() 2023-07-13 22:05:11 -03:00

README.md

Shortcodes

This is a parser for the shortcode spec as explained in the Hugo docs and used in Hugo and Nikola. Approximately.

I am implementing this for Nicolino.

It probably won't be 100% identical, but I'll try to make it as close as practical.

  • Implemented in Ragel + C for performance
  • Allocates no memory, because all strings are references to pieces of input.

What works:

  • Detect shortcodes with names
  • Standalone and matched shortcodes
  • Capture data between tags in matched shortcodes
  • Capture arguments with and without names
  • Capture values with and without quotes (with details, see TODO above)