Argot is a markdown dialect used for text markup. It allows users to format text in a simple yet effective way, making it easy to create documents, web pages, and other content. The language is designed to be intuitive and easy to learn, making it a favorite among developers and writers alike.
Argot goes beyond the regular syntax of Markdown to offer a range of features that include moin-style highlighted code blocks and link target processors. The code blocks come with syntax highlighting using Pygments and can be implemented with an optional shebang and a preferred Pygments parser.
Installing Argot requires Markdown, Pygments, and lxml, which can be a bit difficult to install from pypi. However, Argot does not list lxml as an installation requirement in setup.py, so it's recommended that you fulfill this requirement via lxml's OS bundles.
The moin-style highlighted code blocks in Argot allow you to indent your code blocks without dealing with primitive browser input mechanisms that can result in issues with input focus. This feature is implemented with a general syntax that includes '{{{' followed by a shebang and the Pygments parser you have selected, followed by your code block and bookended with '}}}'.
In addition to this, Argot's link target processors feature allows you to customize and encode URLs in a way that is intuitive and efficient. By using a processor tag and a colon, followed by a query for that processor, you can easily encode the target information in a customizable manner.
While Argot comes with a few built-in link processors, writing new processors is also very easy. The tag for the processor can be provided in three different ways - either the name of the function before the first underscore, a tag attribute on the function, or an optional second argument to `enable_link_processor`.
Overall, Argot is a great tool for anyone looking for a more streamlined and powerful way to write technical blog entries. With its range of features and ease of use, it is definitely worth checking out for anyone interested in Markdown extensions.
Version 0.3: N/A