search

gethugothemes / academia-hugo

Academia is a Hugo resume theme. You can showcase your academic resume, publications and talks using this theme.
https://gethugothemes.com/products/academia/?utm_source=academia_github&utm_medium=referral&utm_campaign=github_theme_about
MIT License
202 stars 181 forks source link

Documention links borked #35

Open darrenaddy opened 2 years ago

darrenaddy commented 2 years ago

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 commented 2 years ago

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.