jgdr/content/article/int-break.md

---
title: "How to break or debug this site 🐛 🧨⚫ "
date: "2023-07-15T17:21:32+03:00"
author: "anybody"
contributors: ["constantinos-miltiadis.md"] 
draft: false 
keywords:
  - draft
  - internal
  - guide
  - debug
abstract: |
  Common reasons why the site breaks and would not compile, either locally or on the server.
---


# Break local & online version 

-  `print` items that point to to inexistent files (e.g. a print item with field `print: "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
	```