gohugoio / hugo

The world’s fastest framework for building websites.
https://gohugo.io
Apache License 2.0
75.01k stars 7.47k forks source link

Unable to do Quick Start due to issues with Hyde #1749

Closed cfjedimaster closed 8 years ago

cfjedimaster commented 8 years ago

Following the Quick Start, when I do

hugo server --theme=hyde --buildDrafts

I get a large number of errors, all roughly the same:

ERROR: 2016/01/03 template: theme/partials/sidebar.html:4:23: executing "theme/partials/sidebar.html" at <.Site.BaseURL>: BaseURL is not a field of struct type hugolib.SiteInfo in theme/partials/sidebar.html ERROR: 2016/01/03 template: theme/partials/head.html:14:39: executing "theme/partials/head.html" at <.Site.BaseURL>: BaseURL is not a field of struct type hugolib.SiteInfo in theme/partials/head.html ERROR: 2016/01/03 template: theme/partials/sidebar.html:4:23: executing "theme/partials/sidebar.html" at <.Site.BaseURL>: BaseURL is not a field of struct type hugolib.SiteInfo in theme/partials/sidebar.html ERROR: 2016/01/03 Error while rendering 404 page: template: theme/404.html:8:123: executing "theme/404.html" at <.Site.BaseURL>: BaseURL is not a field of struct type hugolib.SiteInfo

bep commented 8 years ago

You use an old version of Hyde. Please update.

bep commented 8 years ago

Thanks for getting in touch, but it feels like this is a question that would be better suited to the Hugo Discussion Forum. We prefer to use GitHub issues only for bugs and enhancements. Feel free to update this issue with a link to the re-posted question (so that other people can find it) or add some more details if you feel this is a genuine bug.

cfjedimaster commented 8 years ago

I got this because the documentation says to use Brew as the easiest option and the Brew version is old. Therefore, this bug should be reopened, right? Or at least a new bug filed to update the version available via Brew. Right? (If no bug exists, I'll file one.)

bep commented 8 years ago

The Brew version should be up to date. Try a "brew upgrade". This is a case for the discussion forum. We got plenty of real issues and not too many people to handle it. Remember, this is an open source project with people doing free work on their spare time.

cfjedimaster commented 8 years ago

I understand what an OS project is and I manage plenty of my own. If a user follows the directions the site provides and it doesn't work, is that not a bug in the documentation versus a support request? What exactly am I doing wrong here? And as far as I know, I had no previous version of Hugo and installed fresh yesterday.

cfjedimaster commented 8 years ago

As an FYI, and I'm new to brew, but "brew info hugo" shows hugo: stable 0.13, HEAD

digitalcraftsman commented 8 years ago

I'm not a homebrew user but a quick look in the repository showed that the latest release v0.15 is the most up to date version that is listed.

cfjedimaster commented 8 years ago

@digitalcraftsman - right - which is the version you get if you download manually, but not via brew. As I've said, if the issue is "someone needs to push new bits to Brew", I'm happy to file a new report. But right now,a new user (like me :) can't go through the quick start because of this issue.

bep commented 8 years ago

Brew and Hugo 0.15 is confirmed to work. If you have problems with Brew, please file an issue on their repo.

cfjedimaster commented 8 years ago

So are you saying an install from Brew, which according to brew info is 0.13, should work? Or are you saying Brew should install 0.15? Am I using brew info wrong?

digitalcraftsman commented 8 years ago

Other people had problems with the installations via brew too. According to this thread, do this commands resolve your issue?

brew rm Hugo
brew upgrade
brew install hugo
cfjedimaster commented 8 years ago

Did that, and I still get 0.13. brew info hugo still say s0.13 too. brew reports as version 0.9.5.

cfjedimaster commented 8 years ago

Ahah - it was brew update, then upgrade, and that got me going. So it seems like the brew CLI is fundamentally at fault here. If a user is told to use brew to install some app, they will always need to brew update first to ensure they have the latest definitions, which makes it seem like a pretty bad flaw in how brew works. Either way, since it seems like more than myself have been hit by this, does it make sense to edit the docs to add a small warning? Even one line would clear it up I think. (And I can file another bug for that.)

anthonyfok commented 8 years ago

See also #824, #1067, #1537 and #1633

anthonyfok commented 8 years ago

Thanks for the great suggestion, @cfjedimaster! I have just updated the documentation to say brew update && brew install hugo instead of just brew install hugo. Hope that will prevent other new brew and Hugo users from running into brew-related installation problems. :wink:

cfjedimaster commented 8 years ago

That's perfect - thank you (everyone) for the help. Loving Hugo.

On Tue, Jan 5, 2016 at 12:45 AM, Anthony Fok notifications@github.com wrote:

Thanks for the great suggestion, @cfjedimaster https://github.com/cfjedimaster! I have just updated the documentation to say brew update && brew install hugo instead of just brew install hugo. Hope that will prevent other new brew and Hugo users from running into brew-related installation problems. [image: :wink:]

— Reply to this email directly or view it on GitHub https://github.com/spf13/hugo/issues/1749#issuecomment-168918107.

Raymond Camden, Developer Advocate for MobileFirst at IBM

Email : raymondcamden@gmail.com Blog : www.raymondcamden.com Twitter: raymondcamden

github-actions[bot] commented 2 years ago

This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.