@@ -403,20 +403,29 @@ If you have a different question, please ask using [Discussions](https://github.
403
403
(Relevant issue: [ 130] ( https://github.com/alshedivat/al-folio/issues/130 ) .)
404
404
405
405
3 . ** Q:** My webpage works locally.
406
+ But after deploying, it fails to build and throws ` Unknown tag 'toc' ` .
407
+ How do I fix that? <br >
408
+ ** A:** Make sure you followed through the [ deployment instructions] ( #deployment ) in the previous section.
409
+ You should have set the deployment branch to ` gh-pages ` .
410
+ (Related issue: [ 1438] ( https://github.com/alshedivat/al-folio/issues/1438 ) .)
411
+
412
+ 4 . ** Q:** My webpage works locally.
406
413
But after deploying, it is not displayed correctly (CSS and JS is not loaded properly).
407
414
How do I fix that? <br >
408
415
** A:** Make sure to correctly specify the ` url ` and ` baseurl ` paths in ` _config.yml ` .
409
416
Set ` url ` to ` https://<your-github-username>.github.io ` or to ` https://<your.custom.domain> ` if you are using a custom domain.
410
417
If you are deploying a personal or organization website, leave ` baseurl ` blank.
411
418
If you are deploying a project page, set ` baseurl: /<your-project-name>/ ` .
412
-
413
- 4 . ** Q:** Atom feed doesn't work. Why?
419
+ If all previous steps were done correctly, all is missing is
420
+ [ for your browser to fetch again the site stylesheet] ( https://github.com/alshedivat/al-folio/issues/1398#issuecomment-1609518404 ) .
421
+
422
+ 5 . ** Q:** Atom feed doesn't work. Why?
414
423
<br >
415
424
** A:** Make sure to correctly specify the ` url ` and ` baseurl ` paths in ` _config.yml ` .
416
425
RSS Feed plugin works with these correctly set up fields: ` title ` , ` url ` , ` description ` and ` author ` .
417
426
Make sure to fill them in an appropriate way and try again.
418
427
419
- 5 . ** Q:** My site doesn't work when I enable ` related_blog_posts ` . Why? <br >
428
+ 6 . ** Q:** My site doesn't work when I enable ` related_blog_posts ` . Why? <br >
420
429
** A:** This is probably due to the [ classifier reborn] ( https://github.com/jekyll/classifier-reborn ) plugin, which is used to calculate
421
430
related posts. If the error states ` Liquid Exception: Zero vectors can not be normalized... ` , it means that it could not calculate related
422
431
posts for a specific post. This is usually caused by [ empty or minimal blog posts] ( https://github.com/jekyll/classifier-reborn/issues/64 )
0 commit comments