Skip to content

Commit 554ab34

Browse files
authored
Updated README FAQ section (alshedivat#1532)
1 parent 567b731 commit 554ab34

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

README.md

+12-3
Original file line numberDiff line numberDiff line change
@@ -403,20 +403,29 @@ If you have a different question, please ask using [Discussions](https://github.
403403
(Relevant issue: [130](https://github.com/alshedivat/al-folio/issues/130).)
404404

405405
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.
406413
But after deploying, it is not displayed correctly (CSS and JS is not loaded properly).
407414
How do I fix that? <br>
408415
**A:** Make sure to correctly specify the `url` and `baseurl` paths in `_config.yml`.
409416
Set `url` to `https://<your-github-username>.github.io` or to `https://<your.custom.domain>` if you are using a custom domain.
410417
If you are deploying a personal or organization website, leave `baseurl` blank.
411418
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?
414423
<br>
415424
**A:** Make sure to correctly specify the `url` and `baseurl` paths in `_config.yml`.
416425
RSS Feed plugin works with these correctly set up fields: `title`, `url`, `description` and `author`.
417426
Make sure to fill them in an appropriate way and try again.
418427

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>
420429
**A:** This is probably due to the [classifier reborn](https://github.com/jekyll/classifier-reborn) plugin, which is used to calculate
421430
related posts. If the error states `Liquid Exception: Zero vectors can not be normalized...`, it means that it could not calculate related
422431
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

Comments
 (0)