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.
- First, check the logs of you Pipeline job in GitLab.
- You may have an error in
zensical.tomlconfiguration. - You may have an syntax code error in one of your Markdown files.
- Your website is too large (max 500MB) published.
- There is a problem with the GitLab server (retry, otherwise contact System admin or your instructor).
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, GitLab will not published new versions anymore.
- Replacing / deleting all large files with a smaller version
- Removing large files and linking them on google-drive, or in a separate files repository
Errors in zensical.toml
You can easily spot this looking as the pipeline error is mentioning an "error" in zensical.toml. 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
Try to look at pervious commit history, to see what you change to give you a clue what did not work. Do not copy and paste from Microsoft Word documents, as this may cause unknown invisible characters to be added to the document.