mdcms/docs/knownlimitations.md

1.2 KiB

MD-CMS — Known limitations

MD-CMS is under active development.

mdcms.py only targets /website directory inside a project directory

You can run mdcms.py from anywhere and define multiple projects. However, the current version excepts the website itself to live inside a /website directory inside your project directory.

In other words, you cannot keep the files in

  • /home/username/mdcmssites/site-1 and
  • /home/username/mdcmssites/site-2

they must be in

  • /home/username/mdcmssites/site-1/website and
  • /home/username/mdcmssites/site-2/website.

mdcms tags for posts

The tags that lists posts are broken. Currently, the only tags that reliably show posts are:

  • posts-datetime-chronological-byyearmonth
  • posts-datetime-reversechronological

To correctly show posts, use datetime in frontmatter.

The tag created is defined in the frontmatter as the created date of a file, but it is not used.

Use datetime to indicate the date and time a file was created, using the format YYYY-MM-DD HH:MM (e.g., 2026-01-14 13:35).

Use modified using the format YYYY-MM-DD HH:MM (e.g., 2026-01-14 13:35) to show users when a file was last updated.