gohugoio / hugoBasicExample

MIT License
281 stars 281 forks source link

Corrections #47

Closed onedrawingperday closed 5 years ago

onedrawingperday commented 5 years ago

Following @bep 's feedback in #45

  1. Removed HTML syntax and renamed the guide to Markdown Syntax Guide see: https://github.com/gohugoio/hugoBasicExample/pull/47/commits/07ebf20b7695756920c276b492102164fb1c175a#diff-7a05d42bfcff7861c34afd2edae9f774

Also I have kept the HTML syntax for sub, sup (as it's much simpler to enter these tags directly in Markdown than enabling the relevant Blackfriday extensions (besides that is already documented in the Docs proper).

  1. Removed the entire section about Custom Emoji since the replaceRE function is meant for important things, (however please note that for some people it is very important to use custom emoji because they feel restricted by the Unicode emoji).

  2. Regarding the symlinks.

The /post/ section is enabled by default in this repository.

The /posts/ section contains aliases to the content files of the above section and it is meant for themes on the Hugo Themes website that use the plural form of /post/. The hugoThemeSiteScript now detects this section and enables it automatically while disabling the singular form name of this section.

Since Theme Demos inherit their content from this repo now I had to accommodate existing themes that were using a hardcoded /posts/ section and therefore had their list pages rendered empty. These are mostly old themes that predate mainSections.

That's why I opted for the symlinks. In my local tests the Build Script serves these without any problem.

If you need further changes @bep then let me know.

Thanks.

cc: @digitalcraftsman