Is there any book, MOOC or comprehensive tutorial for Hugo ? Far too many tutorials are content simply by showing how to create a new site, apply a theme, change the title or whatever and then say “good luck, that’s it !”. The equivalent of showing a hello world program and tells you to peruse the standard library.

I came here looking for the same thing. While reading the docs I had the same thought as buddha314 - the people writing the docs are too close to the subject matter. There are a ton of details which are great for advanced users, but the higher level info on here’s what Hugo can do and why you might want to customize this or that piece is harder to find. When you don’t have the background information, the details can get kind of overwhelming. I’ve only just started looking at it but this appears to be the closest thing mentioned here to what I was looking for: http://danbahrami.io/articles/building-a-production-website-with-hugo-and-gulp-js/

Very sad that the Hugo Experts with the skills to create accurate up to date documentation don’t realize the importance of the new user community in promoting their wonderful product. The article you referenced is almost 3 years old, and while it may be accurate, it would be better if something like it was part of the official Hugo Documentation ( for new users ). One way for an expert “too close to the subject matter” to write instructions for a new user is to actually work with them for 20 minutes and ask them to get a site running and produce their first post. I doubt most new users could accomplish the task given the current state of the documentation. For anyone thinking this is a rarely occurring issue, please consider this topic has had 1.4K views since June. Also, a quick search of this forum shows many frustrated newbies.

When I started using Hugo a number of years ago, the documentation was less well developed than it is now. It has been improved immensely through the hard work of many volunteers. I tried to read everything, and read it again. I don’t think there’s a substitute for that. I had to pester people in here a lot, to try to get the info I needed. Many of the complaints I see are the result of a) people not knowing the basics of front end web development (not a hugo problem) and/or, simply refusing to read through the docs or search them. If you see that something’s lacking, please contribute. Even as a Hugo beginner, you can somehow pick through steps to get a basic site running, take notes, and send a pull request to improve the basic tutorials. That is to say, yes, I agree: there’s always room for improvement.

[image] mojoa: I doubt most new users could accomplish the task given the current state of the documentation. When I started using hugo, I had no problem getting a basic site up and running by following the docs. As @RickCogley mentioned, read, then re-read. I usually learn something new when I revisit the documentation. ——— If you have things to contribute to the docs, but don’t yet know how, there is never a better time to learn than now. There are many wonderful resources on the web. Here are a few of my favorites :slight_smile: Command Line and Text Editor [image] Learn Enough Command Line to Be Dangerous A tutorial introduction to the Unix command line [image] Introduction to the Terminal Course 112-minute Development Tools course: Apps for ordinary users use GUIs you control with a mouse or touchscreen. But developers know the most powerfu... [image] Learn Enough Text Editor to Be Dangerous A tutorial introduction to text editors Git [image] Learn Enough Git to Be Dangerous An Introduction to Version Control with Git How to Use Git? Tutorials, Workflows & Commands | Atlassian Git is an open source version control system used by programmers to manage their code. Learn about its features and benefits in this tutorial. [image] Introduction to Git Course 186-minute Development Tools course: Git is a version control system - it helps you manage the different versions of your project files, and helps ... HTML and CSS [image] Learn Enough HTML to Be Dangerous A tutorial introduction to HTML [image] Learn Enough CSS Layout to Be Dangerous An introduction to CSS and page layout, including static site generation with Jekyll [image] Master Web Design and Launch Your Tech Career Master web design with Treehouse. Learn HTML, CSS, color theory, and typography to boost your skills and secure a tech job. Start your journey today.

[image] zwbetz: If you have things to contribute to the docs, but don’t yet know how, there is never a better time to learn than now. There are many wonderful resources on the web. Here are a few of my favorites :slight_smile: These look like excellent references… you should add them to the Hugo Documentation. :slightly_smiling_face: I think if you search the Forum you will find many frustrations from people who take issue with the initial Hugo learning curve. You can argue they don’t have the basic skills, or are too lazy to read and re-read the documentation, but the fact is, they leave and are no longer Hugo proponents. I believe this problem can be fixed by people who have adequate knowledge of Hugo and put together a step by step, copy and paste, start to finish guide. It should not be an effort by newbies to cobble together some notes about what they think they know. From a recent post: That said, I do agree with you that the Install Hugo page does need a reorganization. It has been worked on by many different people over time, and it has become somewhat inconsistent, with generic instruction (e.g. compiling from source) misplaced under the macOS-specific instruction, and with various “caveats” removed for the sake of simplicity, but at the cost of sacrificing ease troubleshooting. And to highlight the focus. [image] spf13Hugo Creator Oct '15 We should do more to cater to the beginning web developers/content creators. We would love help with this. Even just questions beginners have would be a huge help.

This might come off as facetious, but I want assure everyone: I am being serious. [image] mojoa: You can argue they don’t have the basic skills, or are too lazy to read and re-read the documentation, but the fact is, they leave and are no longer Hugo proponents. I don’t think anyone is too lazy, or rather it is certainly rare for a person just wanting to be told what to do to join the forums. Most folks are more likely new to getting remote support, don’t know how to use docs, or maybe are new to web development., but they all want to figure out how to make their website. Let’s talk about that last part, though: “they leave and are no longer Hugo proponents”. Do we care about that? Do we adjust documentation so anyone, regardless of skill can use Hugo and have a pleasant experience? I don’t know. Websites are hard, in a general sense. We do weird things and interact with weird services, often in ways that are counter-intuitive. And Hugo embraces the weird parts, because otherwise you could just install WordPress and worry only about the content side. So let’s hold off drawing a line in the sand immediately. Let’s remain open to embracing all users, and helping them along. How do we do that? We’re going to need to hire a document engineer to work with everyone committing. They’ll need to track the direction of the project, to know which docs will be changing. They’ll need to work with all the package maintainers, to ensure the install directions remain the same for all users on all platforms, even as we adjust how the extended binary is used. They’ll need to explain the basics of web-based communication, the portion that static site generators participate in, and then how Hugo and golang abstract those concepts in a particular way, but mostly how go templates can’t be used in markdown files… It’s not where the project is right now. We’ll get there. But our volunteer band will need to either inherit an incredible amount of boring leisure time, or you’ll need to inspire documentation itches that need to be scratched, during this phase of rapid development. Also, as the project gets more popular, we are going to draw more folks with less experience. That’s numbers. But there are a lot of Hugo sites out there, built by people that don’t actively participate in these forums, and they got through the docs just fine. Let’s be aware of negativity bias while appreciating new user frustration. Let’s not forget the hundreds of support topics solved each month! [image] mojoa: These look like excellent references… you should add them to the Hugo Documentation. :slightly_smiling_face: Right back at ya! :slight_smile:

As someone only an hour into Hugo, I want to convey how frustrating this conversation is. @maiki’s reply is basically giving excuses for not doing what is obvious: Push the tutorial in the Quick Start guide further, so that the basics of website authoring are covered. My one-sentence background: I’m in the process of evaluating Hugo as the tool for our “static” (from the server-side) web sites. Getting Hugo up and running was no problem, and I was able to choose a theme and start writing blog posts by working through the Quick Start guide. Great. Naturally, I wanted to start including images and video. But the next page in the Getting Started series, ignoring the Install Hugo page coming after the Quick Start Guide, goes into the basics of Hugo’s command-line options. No problem, I’ll just skip ahead to where the image and video stuff must be. The problem is that it isn’t obvious where that is. I clicked around a bit, but it was past quitting time. So I gave up and left…and very nearly dropped Hugo. Luckily, I’m stubborn and picked it up again this morning and decided to check out Mike Dane’s YouTube video that is embedded on the Directory Structure page. At this point, I will work through Mike’s video tutorial series to figure out if Hugo will suit our needs…but I still don’t know how to put images on a page in Hugo. The solution seems obvious to me. Just push the tutorial in the Quick Start page further. If it covered a basic blog, including images, embedded video, internal/external links, and the more obvious stuff that nearly every website uses, it would be a huge improvement. Instead, the new user is launched into what is basically reference material, and they don’t know enough to know how to navigate that material. The point of the Quick Start guide is to get the user to the point where they can do something useful and give them a reason to push further. After finishing the Quick Start guide, I can put up a text-only blog. That’s just not enough. This is low-hanging fruit here. Honestly, every day that this goes unaddressed is a day of delay of Hugo’s adoption. If I happen to catch Hugo fever and learn the tool properly, I’d be happy to try to push the Quick Start guide further, but I’m not the right person for that at the moment and may never be.

[image] Mark: Naturally, I wanted to start including images and video Content uses Markdown. So let’s say you wanted to include an image from your static/ folder: ![alt text](path/to/image.jpg) You can also write HTML directly inside your Markdown. If you wanted to store your images in the same folder as your post, you could access them as page resources by using shortcodes. For tutorials and tips n tricks outside the docs, checkout: the “hugo tutorials” section of the recommended reading the awesome hugo list

As someone who started just a couple of weeks ago using Hugo I found mike Danes tutorials very useful. Did they answer every question? No ,but it gave me the basic structure that I needed to know how to get started even without using a theme. No matter what you decide to learn there will always be specifics that you’ll have to dig up to personalise your site. I don’t think that’s what a tutorial is for. I admit though that I wish they were more specific sometimes. I think Mike’s tutorial is probably about as low level as you can be and still understand the structure needed to create your own theme, assuming you know some html and css. There were a couple of details left out that I asked in this forum and got answers to. Between that and some Google searches I figured it out, I think. Time will tell, but I’m sure I’ll be back asking more newb questions. I’m not sure if this helps but hang in there and keep asking questions. Respectfully

Comprehensive hugo tutorial for beginners?

support

pointyfar October 19, 2018, 7:23am 21

That’s a very nice list. I wish I had it when I was starting out!

Topic		Replies	Views
Tutorial support	15	3221	February 3, 2017
Request: hugo with a 'hello world' example? feature	19	3176	April 5, 2022
NEW DOCS SITE! Need feedback! support	44	7816	June 13, 2017
Hacker News is discussing Hugos documentation, pain points Meta	42	5367	December 5, 2024
Hugo 101: Slowstart for beginners tips & tricks	21	15804	May 7, 2020

Comprehensive hugo tutorial for beginners?

Related topics