academia-hugo icon indicating copy to clipboard operation
academia-hugo copied to clipboard

Documention links borked

Open darrenaddy opened this issue 2 years ago • 1 comments

Hello. Thanks for this nice theme! I just wanted to note that in the README.md of this theme on GitHub, under "Local Development" the link to "Full Documentation" is a 404 error on docs.gethugothemes.com/academia/

Also, the params.toml file (in exampleSite/config/_default/params.toml ) starts out with #SITE SETUP followed by a documentation link that REDIRECTS to the wowchemy.com home page. (There may be other files that link to documention, but these are the first two that I discovered.) Thank you!

darrenaddy avatar Mar 23 '22 19:03 darrenaddy

OK. After investigating, I think I get it. Academia is basically wowchemy's Academic. The borked links are because a search & replace was done on a fork of that codebase which also affected the URLs. If you change the URLs (that I referenced) from "/academia/" to "/academic/" (for example) you will find the original Wowchemy docs (which reference the Academic starter theme a lot). For example: This page on updating Wowchemy says: "To find your current version, look in themes/academic/data/academic.toml if it exists. " If you check for that file in Academia, it exists and says version = "4.3.1" So if you are looking at Academic documentation, I would imagine that one would need to take care not to reference any features found in later versions of Academic. EDIT: In looking at the /css/academia.min file generated in the Public folder when building the static pages, it is built with Bootstrap 4.3.1 - I doubt that this is a coincidence. so the "version" of the Academic you are using seems to be dependent upon the version of the Bootstrap you are using.

darrenaddy avatar Mar 24 '22 14:03 darrenaddy