Ben Chuanlong Du's Blog

It is never too late to learn.

Markdown vs RestructureText vs MyST for Documentation

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement!

Comparison

  1. Compared to Markdown, RestructuredText is more fully-featured, much more standardized and uniform, and has built-in support for extensions. However, ReStructuredText is also criticized for its complex and confusing syntax. The …

Markedly Structured Text

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement!

MySt is an extension of CommonMarkdown with some goodies introduced from RestructuredText. The jupyter-book project supports MySt syntax.

References

https://github.com/executablebooks/MyST-Parser

https://myst-parser.readthedocs.io/en/latest/

Dunder/Magic Methods in Python

__call__ (Object Invocation)

We can make any object callable like a regular function by adding the call dunder method. Let’s consider the below toy(not very meaningful) example just to showcase the call method.

Header Files in Linux

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement!

limits.sh: libc-dev

Tips on Blogging

This post contains tips for blogging @ blog.

  1. Avoid using tags ending with a number. For example, cv2 should be avoid as it causes duplicated page navigation issues (without extra configuration effort.)