Troubleshooting
You received a pipeline filed error
This means Gitlab is not able to regenerate your site. This might happen for different reasons check the options below.
1. Your website is too large
2. You have some error in your mkdocs.yml file
3. You have some error in your markdown files
Website too large
You can easily spot this looking at the pipeline error page, look for the message “Artifact size is too large..”.
**If your website is over 500mb size it won’t be published anymore. **
This can be solved by:
* Replacing / deleting all large files with a smaller version
* Removing large files and linking them on google-drive, or in a separate files repository
* Removing videos and using youtube or vimeo for hosting them
Errors in mkdocs.yml
You can easily spot this looking as the pipeline error is mentioning an “error in mkdocs.yml”. Read the error message and see which line is giving an error. You can also browse the older versions of your file and restore it, then checking what is wrong.
Errors in Markdown files
Check if you linked missing files in mkdocs.yml or used a strange charset when editing your markdown files. Don’t copy and paste from Microsoft Word documents, as this may cause unknown invisible characters to be added to the document.