Hugo In Action

Code Sections

The branches in this repository correspond to the sections of Hugo In Action. Each chapter also has a branch with all the resource files that can used to build the Acme Corporation website following the steps as discussed in the book.

Branch / Code Section	Book Section	Changes	URL	Delta
Chapter 2	Resources
chapter-02-01	2.1	Create Website skeleton	N/A	N/A
chapter-02-02	2.2	Added theme - Eclectic	https://chapter-02-02.hugoinaction.com	chapter-02-01..chapter-02-02
chapter-02-03	2.3.1	Add configuration to the website	https://chapter-02-03.hugoinaction.com	chapter-02-02..chapter-02-03
chapter-02-04	2.3.3	Added content - index, about, contact, privacy and terms of use page for the website.	https://chapter-02-04.hugoinaction.com	chapter-02-03..chapter-02-04
chapter-02-05	2.6	Update to theme universal.	https://chapter-02-05.hugoinaction.com	chapter-02-04..chapter-02-05
Chapter 3	Resources
chapter-03-01	3.1.2	Added block formatting (and first version of markdown.md)	https://chapter-03-01.hugoinaction.com	chapter-02-05..chapter-03-01
chapter-03-02	3.1.3	Added inline formatting & updates to the privacy policy page	https://chapter-03-02.hugoinaction.com	chapter-03-01..chapter-03-02
chapter-03-03	3.2	Added HTML characters, tables, task lists, code blocks and definition lists	https://chapter-03-03.hugoinaction.com	chapter-03-02..chapter-03-03
chapter-03-04	3.6.1	Add YAML metadata.	https://chapter-03-04.hugoinaction.com	chapter-03-03..chapter-03-04
chapter-03-05	3.6.2	Add data-driven example.	https://chapter-03-05.hugoinaction.com	chapter-03-04..chapter-03-05
chapter-03-06	3.7	Test out Universal.	https://chapter-03-06.hugoinaction.com	chapter-03-05..chapter-03-06
Chapter 4	Resources
chapter-04-01	4.1	Split config file.	https://chapter-04-01.hugoinaction.com	chapter-03-06..chapter-04-01
chapter-04-02	4.2.1	Added blog entries.	https://chapter-04-02.hugoinaction.com	chapter-04-01..chapter-04-02
chapter-04-03	4.2.2	Adding menu entries.	https://chapter-04-03.hugoinaction.com	chapter-04-02..chapter-04-03
chapter-04-04	4.3.1	Adding page bundles.	https://chapter-04-04.hugoinaction.com	chapter-04-03..chapter-04-04
chapter-04-05	4.3.2	Adding branch bundles.	https://chapter-04-05.hugoinaction.com	chapter-04-04..chapter-04-05
chapter-04-06	4.3.3	Added cover images.	https://chapter-04-06.hugoinaction.com	chapter-04-05..chapter-04-06
chapter-04-07	4.4	Adding tags and categories to various blog posts.	https://chapter-04-07.hugoinaction.com	chapter-04-06..chapter-04-07
chapter-04-08	4.4	Add index page for categories and for the design category.	https://chapter-04-08.hugoinaction.com	chapter-04-07..chapter-04-08
chapter-04-09	4.4	Update taxonomy and convert manufacturing process to a series.	https://chapter-04-09.hugoinaction.com	chapter-04-08..chapter-04-09
chapter-04-10	4.5	Add youtube video	https://chapter-04-10.hugoinaction.com	chapter-04-09..chapter-04-10
chapter-04-11	4.6.1	Add divider shortcode	https://chapter-04-11.hugoinaction.com	chapter-04-10..chapter-04-11
chapter-04-12	4.6.2	Use shared shortcode productInfo.	https://chapter-04-12.hugoinaction.com	chapter-04-11..chapter-04-12
Chapter 5	Resources
chapter-05-01	5.1.1	Using variables to access content.	https://chapter-05-01.hugoinaction.com	chapter-04-12..chapter-05-01
chapter-05-02	5.1.2	Use 'if' checks for existence.	https://chapter-05-02.hugoinaction.com	chapter-05-01..chapter-05-02
chapter-05-03	5.1.3	Falling back to the website title.	https://chapter-05-03.hugoinaction.com	chapter-05-02..chapter-05-03
chapter-05-04	5.1.4	Using variables.	https://chapter-05-04.hugoinaction.com	chapter-05-03..chapter-05-04
chapter-05-05	5.1.5	Using defaults and $.Param.	https://chapter-05-05.hugoinaction.com	chapter-05-04..chapter-05-05
chapter-05-06	5.1.6	Using the 'with' conditional. Add footer	https://chapter-05-06.hugoinaction.com	chapter-05-05..chapter-05-06
chapter-05-07	5.1.7	Use humanize and markdownify functions	https://chapter-05-07.hugoinaction.com	chapter-05-06..chapter-05-07
chapter-05-08	5.1.8	Adding markdown content to the index page.	https://chapter-05-08.hugoinaction.com	chapter-05-07..chapter-05-08
chapter-05-09	5.2.1	Remove hard coded links and add menus as a section, header and footer	https://chapter-05-09.hugoinaction.com	chapter-05-08..chapter-05-09
chapter-05-10	5.2.2	Added a list of recent blog posts to the home page.	https://chapter-05-10.hugoinaction.com	chapter-05-09..chapter-05-10
chapter-05-11	5.3.1	Added testimonials based on front matter.	https://chapter-05-11.hugoinaction.com	chapter-05-10..chapter-05-11
chapter-05-12	5.3.2	Rendering and allowing data from tables.	https://chapter-05-12.hugoinaction.com	chapter-05-11..chapter-05-12
chapter-05-13	5.4.1	Added price shortcode.	https://chapter-05-13.hugoinaction.com	chapter-05-12..chapter-05-13
chapter-05-14	5.4.2	Added repeat shortcode.	https://chapter-05-14.hugoinaction.com	chapter-05-13..chapter-05-14
chapter-05-15	5.4.3	Added archetypes	https://chapter-05-15.hugoinaction.com	chapter-05-14..chapter-05-15
Chapter 6	Resources
chapter-06-01	6.1.1	New Content type - modern.	https://chapter-06-01.hugoinaction.com	chapter-05-15..chapter-06-01
chapter-06-02	6.1.3	Add baseof.html and split out the base template with default implementation.	https://chapter-06-02.hugoinaction.com	chapter-06-01..chapter-06-02
chapter-06-03	6.1.4	Moving terms of use to modern type.	https://chapter-06-03.hugoinaction.com	chapter-06-02..chapter-06-03
chapter-06-04	6.1.4	Moving the footer/main menu to the base template.	https://chapter-06-04.hugoinaction.com	chapter-06-03..chapter-06-04
chapter-06-05	6.2.1	Render footer menu using partials in the footer and intro sections.	https://chapter-06-05.hugoinaction.com	chapter-06-04..chapter-06-05
chapter-06-06	6.2.2	Reduce the scope of the context variable to the menu partial	https://chapter-06-06.hugoinaction.com	chapter-06-05..chapter-06-06
chapter-06-07	6.2.2	Reuse the partial for the header menu.	https://chapter-06-07.hugoinaction.com	chapter-06-06..chapter-06-07
chapter-06-08	6.2.3	Render submenus.	https://chapter-06-08.hugoinaction.com	chapter-06-07..chapter-06-08
chapter-06-09	6.2.4	Move the privacy policy to modern.	https://chapter-06-09.hugoinaction.com	chapter-06-08..chapter-06-09
chapter-06-10	6.2.4	Enable partialCached with excessive caching(broken).	https://chapter-06-10.hugoinaction.com	chapter-06-09..chapter-06-10
chapter-06-11	6.2.4	Add additional arguments to fix partialCached.	https://chapter-06-11.hugoinaction.com	chapter-06-10..chapter-06-11
chapter-06-12	6.2.5	Move shortcode to partialCached to speed up.	https://chapter-06-12.hugoinaction.com	chapter-06-11..chapter-06-12
chapter-06-13	6.3.1	Move index.css to the assets folder.	https://chapter-06-13.hugoinaction.com	chapter-06-12..chapter-06-13
chapter-06-14	6.3.1	Use SCSS compilation for index.(s)css.	https://chapter-06-14.hugoinaction.com	chapter-06-13..chapter-06-14
chapter-06-15	6.3.1	Using color from the parameters.	https://chapter-06-15.hugoinaction.com	chapter-06-14..chapter-06-15
chapter-06-16	6.3.1	Changing the theme color.	https://chapter-06-16.hugoinaction.com	chapter-06-15..chapter-06-16
chapter-06-17	6.3.1	Use resources.concat to merge multiple resources.	https://chapter-06-17.hugoinaction.com	chapter-06-16..chapter-06-17
chapter-06-18	6.3.1	Add hero image for home page.	https://chapter-06-18.hugoinaction.com	chapter-06-17..chapter-06-18
chapter-06-19	6.3.2	Add cover images for blog posts.	https://chapter-06-19.hugoinaction.com	chapter-06-18..chapter-06-19
chapter-06-20	6.3.2	Image resizing for optimized loading	https://chapter-06-20.hugoinaction.com	chapter-06-19..chapter-06-20
chapter-06-21	6.3.2	Dynamically recolor the favicon.	https://chapter-06-21.hugoinaction.com	chapter-06-20..chapter-06-21
chapter-06-22	6.3.2	Create card layout for the company products.	https://chapter-06-22.hugoinaction.com	chapter-06-21..chapter-06-22
chapter-06-23	6.5.0	Add metadata via internal templates.	https://chapter-06-23.hugoinaction.com	chapter-06-22..chapter-06-23
chapter-06-24	6.5.0	Using '.TableOfContents' method to fill table of contents.	https://chapter-06-24.hugoinaction.com	chapter-06-23..chapter-06-24
Chapter 7	Resources
chapter-07-01	7.1.2	Change the CSS class of the news section using the path check.	https://chapter-07-01.hugoinaction.com	chapter-06-24..chapter-07-01
chapter-07-02	7.1.4	Adding blog layout and overriding the blog section with this new layout.	https://chapter-07-02.hugoinaction.com	chapter-07-01..chapter-07-02
chapter-07-03	7.1.5	Added configuration for related pages provided by Hugo.	https://chapter-07-03.hugoinaction.com	chapter-07-02..chapter-07-03
chapter-07-04	7.2.1	Provide the index page template 'list.html' to blog/community pages.	https://chapter-07-04.hugoinaction.com	chapter-07-03..chapter-07-04
chapter-07-05	7.2.2	Support Pagination in the index/list pages	https://chapter-07-05.hugoinaction.com	chapter-07-04..chapter-07-05
chapter-07-06	7.2.4	Listing subsection content on the index page	https://chapter-07-06.hugoinaction.com	chapter-07-05..chapter-07-06
chapter-07-07	7.2.4	Temporarily switch the index to list layout by removing the index template	https://chapter-07-07.hugoinaction.com	chapter-07-06..chapter-07-07
chapter-07-08	7.3	Move category taxonomy to content type Acme.	https://chapter-07-08.hugoinaction.com	chapter-07-07..chapter-07-08
chapter-07-09	7.3.1	Added terms.html.	https://chapter-07-09.hugoinaction.com	chapter-07-08..chapter-07-09
chapter-07-10	7.3.2	Added the taxonomy layout	https://chapter-07-10.hugoinaction.com	chapter-07-09..chapter-07-10
chapter-07-11	7.4.1	Moving all pages to content type modern.	https://chapter-07-11.hugoinaction.com	chapter-07-10..chapter-07-11
chapter-07-12	7.4.1	Creating a new theme named Acme	https://chapter-07-12.hugoinaction.com	chapter-07-11..chapter-07-12
chapter-07-13	7.4.2	Change the content type to default.	https://chapter-07-13.hugoinaction.com	chapter-07-12..chapter-07-13
chapter-07-14	7.4.2	Cleanup the theme and move blogs from layouts to a new content type.	https://chapter-07-14.hugoinaction.com	chapter-07-13..chapter-07-14
chapter-07-15	7.4.3	Provide placeholder resources for the theme to become independent.	https://chapter-07-15.hugoinaction.com	chapter-07-14..chapter-07-15
chapter-07-16	7.4.3	Testing the theme with chapter 4 content	https://chapter-07-16.hugoinaction.com	chapter-07-15..chapter-07-16
chapter-07-17	7.4.3	Revert the chapter 4 content test.	https://chapter-07-17.hugoinaction.com	chapter-07-16..chapter-07-17
chapter-07-18	7.5	Adding a content view for news and blog sections.	https://chapter-07-18.hugoinaction.com	chapter-07-17..chapter-07-18
Chapter 8	Resources
chapter-08-01	8.3	Added theme Eclectic via Hugo Modules.	https://chapter-08-01.hugoinaction.com	chapter-07-18..chapter-08-01
chapter-08-02	8.4	Move shortcodes into website for theme portability and enable theme Universal.	https://chapter-08-02.hugoinaction.com	chapter-08-01..chapter-08-02
chapter-08-03	8.5	Using a specific version of a module (and moving to theme Acme)	https://chapter-08-03.hugoinaction.com	chapter-08-02..chapter-08-03
chapter-08-04	8.6	Creating a vendor folder.	https://chapter-08-04.hugoinaction.com	chapter-08-03..chapter-08-04
chapter-08-05	8.7	Using the replace directive for local development.	https://chapter-08-05.hugoinaction.com	chapter-08-04..chapter-08-05
chapter-08-06	8.8	Add a dependency on the AcmeSupport repository.	https://chapter-08-06.hugoinaction.com	chapter-08-05..chapter-08-06
chapter-08-07	8.9	Using hugo debug utils plugin.	https://chapter-08-07.hugoinaction.com	chapter-08-06..chapter-08-07
chapter-08-08	8.10	Moving shared code between the theme and the website to AcmeCommon	https://chapter-08-08.hugoinaction.com	chapter-08-07..chapter-08-08
chapter-08-09	8.11	Using Hugo Modules for terms of use and privacy policy pages as content plugins.	https://chapter-08-09.hugoinaction.com	chapter-08-08..chapter-08-09
chapter-08-10	8.12	Running hugo mod tidy	https://chapter-08-10.hugoinaction.com	chapter-08-09..chapter-08-10
Chapter 9	Resources
chapter-09-01	9.2.3	Embedding tweet using the twitter OEmbed API and getJSON in Hugo	https://chapter-09-01.hugoinaction.com	chapter-08-10..chapter-09-01
chapter-09-02	9.2.4	Providing cache lifetime to the tweet.	https://chapter-09-02.hugoinaction.com	chapter-09-01..chapter-09-02
chapter-09-03	9.3.1	Creating a HTML form for the contact us page.	https://chapter-09-03.hugoinaction.com	chapter-09-02..chapter-09-03
chapter-09-04	9.4.3	Enable Netlify forms	https://chapter-09-04.hugoinaction.com	chapter-09-03..chapter-09-04
chapter-09-05	9.4.3	Use Formspree for contact us forms	https://chapter-09-05.hugoinaction.com	chapter-09-04..chapter-09-05
chapter-09-06	9.5	Create dynamic surveys in Hugo	https://chapter-09-06.hugoinaction.com	chapter-09-05..chapter-09-06
chapter-09-07	9.6.1	Creating a comment form with support for disabling commenting.	https://chapter-09-07.hugoinaction.com	chapter-09-06..chapter-09-07
chapter-09-08	9.6.2	Rendering past comments by fetching them from the forms service.	https://chapter-09-08.hugoinaction.com	chapter-09-07..chapter-09-08
chapter-09-09	9.7	Generating Pseudo APIs via custom output formats in Hugo.	https://chapter-09-09.hugoinaction.com	chapter-09-08..chapter-09-09
Chapter 10	Resources
chapter-10-01	10.2	Doing form submission via JavaScript.	https://chapter-10-01.hugoinaction.com	chapter-09-09..chapter-10-01
chapter-10-02	10.4.1	Controlling the content shown via the JS code within the HTML template.	https://chapter-10-02.hugoinaction.com	chapter-10-01..chapter-10-02
chapter-10-03	10.4.2	Splitting the JavaScript code into multiple modules	https://chapter-10-03.hugoinaction.com	chapter-10-02..chapter-10-03
chapter-10-04	10.4.3	Compile time variables to control flow of the program	https://chapter-10-04.hugoinaction.com	chapter-10-03..chapter-10-04
chapter-10-05	10.5.3	Showing a search button and loading website data using JavaScript	https://chapter-10-05.hugoinaction.com	chapter-10-04..chapter-10-05
chapter-10-06	10.5.6	Installing and using Fuse.js for fuzzy search.	https://chapter-10-06.hugoinaction.com	chapter-10-05..chapter-10-06
chapter-10-07	10.5.7	Properly showing search results.	https://chapter-10-07.hugoinaction.com	chapter-10-06..chapter-10-07
chapter-10-08	10.5.8	Using Hugo modules with js.Build.	https://chapter-10-08.hugoinaction.com	chapter-10-07..chapter-10-08
chapter-10-09	10.6	Embedding EasyLogic Editor into the website.	https://chapter-10-09.hugoinaction.com	chapter-10-08..chapter-10-09
Chapter 11	Resources
chapter-11-01	11.2.7	Creating a function for LaTeX to SVG conversion	https://chapter-11-01.hugoinaction.com	chapter-10-09..chapter-11-01
chapter-11-02	11.2.10	Render LaTeX based equation during compilation on the Acme Corporation website.	https://chapter-11-02.hugoinaction.com	chapter-11-01..chapter-11-02
chapter-11-03	11.3.2	Creating a function to trigger Netlify rebuilds on comment submission.	https://chapter-11-03.hugoinaction.com	chapter-11-02..chapter-11-03
chapter-11-04	11.3.6	Triggering automatic rebuilds from Netlify forms and Formspree comment submissions	https://chapter-11-04.hugoinaction.com	chapter-11-03..chapter-11-04
chapter-11-05	11.3.7	Using JavaScript to show the comment submission inline to make the perceived performance instantaneous.	https://chapter-11-05.hugoinaction.com	chapter-11-04..chapter-11-05
Chapter 12	Resources
chapter-12-01	12.1.1	Creating content view for store pages.	https://chapter-12-01.hugoinaction.com	chapter-11-05..chapter-12-01
chapter-12-02	12.1.2	Creating a simple template for the store pages.	https://chapter-12-02.hugoinaction.com	chapter-12-01..chapter-12-02
chapter-12-03	12.2	Added shopping cart via JavaScript.	https://chapter-12-03.hugoinaction.com	chapter-12-02..chapter-12-03
chapter-12-04	12.3.2	Added checkout support.	https://chapter-12-04.hugoinaction.com	chapter-12-03..chapter-12-04
chapter-12-05	12.3.4	Enable success screen and buy now.	https://chapter-12-05.hugoinaction.com	chapter-12-04..chapter-12-05
chapter-12-06	12.4	Enable email based fulfillment	https://chapter-12-06.hugoinaction.com	chapter-12-05..chapter-12-06
Chapter 13	Resources
chapter-13-01	13.1.1	Adding another language to our website.	https://chapter-13-01.hugoinaction.com	chapter-12-06..chapter-13-01
chapter-13-02	13.1.1	Adding a different image for localized content.	https://chapter-13-02.hugoinaction.com	chapter-13-01..chapter-13-02
chapter-13-03	13.1.1	Moving french content to a different directory.	https://chapter-13-03.hugoinaction.com	chapter-13-02..chapter-13-03
chapter-13-04	13.1.1	Added string translation and linking to translate pages in the footer.	https://chapter-13-04.hugoinaction.com	chapter-13-03..chapter-13-04
chapter-13-05	13.1.2	Add sitemap.xml and robots.txt(disabled) templates.	https://chapter-13-05.hugoinaction.com	chapter-13-04..chapter-13-05
chapter-13-06	13.1.3	Adding a minimally styled plain format for the website.	https://chapter-13-06.hugoinaction.com	chapter-13-05..chapter-13-06
chapter-13-07	13.2.1	Support going offline by creating a progressive web app.	https://chapter-13-07.hugoinaction.com	chapter-13-06..chapter-13-07
chapter-13-08	13.2.2	Added instant page to prefetch links.	https://chapter-13-08.hugoinaction.com	chapter-13-07..chapter-13-08
chapter-13-09	13.2.3	Added Turbo to make better page transitions.	https://chapter-13-09.hugoinaction.com	chapter-13-08..chapter-13-09

Updates

July 6, 2022 - Fixed some bugs around search results clickability and keyboard handling in chapter 10. Sept 7, 2024 - Removed google analytics async as it is not supported in Hugo any more (https://github.com/gohugoio/hugo/pull/11468/files)

Hugo In Action Website

The website https://hugoinaction.com is hosted from this repository via the hugoinaction.com branch.