1. Break local & online version¶
print
items that point to to inexistent files (e.g. a print item with fieldprint: "article/inexistent-file.md"
) will break the site, and will now allow to compile. This can occur when a target file was renamed, or when a file was converted to draft. Debug by removing all files of the print directory (except_index.md
)- mixing draft and non draft items in collections (e.g. issue that
has_artices: ["article/draft.md", "article/non-draft.md"
). Debug: double check that all children of non-draft items are also non-draft. - Messing up the header (front matter) of a Markdown file:
--- title: "How to break this site ⚫ " date: "2023-07-15T17:21:32+03:00" author: "anybody" <-- forgetting to close any string quote will break contributors: ["jane-contributor.md"] <--forgetting to close any array brackets will break draft: true keywords: - draft <-- not following this syntax/indentation will break abstract: | The text of your abstract. <-- not following this syntax/indentation will break --- <-- removing one or more dashes will break