Hugo uses the config. The user can choose to override that default with one or more site config files using the command line --config switch.
The following is the full list of Hugo-defined variables with their default value in parentheses. Users may choose to override those values in their site config file s. The build configuration section contains global build-realated configuration options. This is only relevant when running hugo serverand it allows to set HTTP headers during development, which allows you to test out your Content Security Policy and similar.
Set titleCaseStyle to specify the title style used by the title template function and the automatic section titles in Hugo.
It defaults to AP Stylebook for title casing, but you can also set it to Chicago or Go every word starts with a capital letter. The following is a typical example of a configuration file. The values nested under params: will populate the. Params variable for use in templates :. In addition to the 3 config options already mentioned, configuration key-values can be defined through operating system environment variables. This is really useful if you use a service such as Netlify to deploy your site.
Look at the Hugo docs Netlify configuration file for an example. The following statement inside. The above is a list of regular expressions. Dates are important in Hugo, and you can configure how Hugo assigns dates to your content pages. You do this by adding a frontmatter section to your config.
If you, as an example, have a non-standard date parameter in some of your content, you can override the setting for date :. The :default is a shortcut to the default settings. The above will set. Date to the date value in myDate if present, if not we will look in datepublishDatelastmod and pick the first valid date.
The others are just names of date parameters case insensitive in your front matter configuration. With that, as an example, using pubDate as a date in front matter, will, by default, be assigned to. The above will try first to extract the value for. The last, :default should not be needed here, but Hugo will finally look for a valid date in :gitdate and then publishDate.The following is a description of the most common commands you will use while developing your Hugo project.
You can test that Hugo has been installed correctly via the help command:. The most common usage is probably to run hugo with your current directory being the input directory. By default, Hugo will not publish:. All three of these can be overridden during both local development and deployment by adding the following flags to hugo and hugo serverrespectively, or by changing the boolean values assigned to the fields of the same name without -- in your configuration :.
Hugo comes with LiveReload built in. There are no additional packages to install. A common way to use Hugo while developing a site is to have Hugo run a server with the hugo server command and watch for changes:. This will run a fully functioning web server while simultaneously watching your file system for additions, deletions, or changes within the following areas of your project organization :.
Whenever you make changes, Hugo will simultaneously rebuild the site and continue to serve content.
Books Make the Best Gifts
As soon as the build is finished, LiveReload tells the browser to silently reload the page. Most Hugo builds are so fast that you may not notice the change unless looking directly at the site in your browser.
This means that keeping the site open on a second monitor or another half of your current monitor allows you to see the most up-to-date version of your website without the need to leave your text editor.
After running hugo server for local web development, you need to do a final hugo run without the server part of the command to rebuild your site. Since Hugo generates a static website, your site can be hosted anywhere using any web server. See Hosting and Deployment for methods for hosting and automating deployments contributed by the Hugo community. You can test that Hugo has been installed correctly via the help command: hugo help The output you see in your console should be similar to the following: hugo is the main command, used to build your Hugo site.
Usage: hugo [flags] hugo [command] Available Commands: check Contains some verification checks config Print the site configuration convert Convert your content to different formats env Print Hugo version and environment info gen A collection of several useful generators.
The hugo Command The most common usage is probably to run hugo with your current directory being the input directory. By default, Hugo will not publish: Content with a future publishdate value Content with draft: true status Content with a past expirydate value All three of these can be overridden during both local development and deployment by adding the following flags to hugo and hugo serverrespectively, or by changing the boolean values assigned to the fields of the same name without -- in your configuration : --buildFuture --buildDrafts --buildExpired LiveReload Hugo comes with LiveReload built in.
Unix absLangURL absURL after anchorize append apply base64 chomp complement cond countrunes countwords dateFormat default delimit dict echoParam emojify eq errorf and warnf fileExists findRE first float ge getenv group gt hasPrefix highlight htmlEscape htmlUnescape hugo humanize i18n Image Functions in index int intersect isset jsonify lang.See themes. This quickstart uses the beautiful Ananke theme.
Now, start the Hugo server with drafts enabled:. Feel free to edit or add new content and simply refresh in browser to see changes quickly You might need to force refresh in webbrowser, something like Ctrl-R usually works.
Your new site already looks great, but you will want to tweak it a little before you release it to the public. Replace the title above with something more personal. Also, if you already have a domain ready, set the baseURL. Note that this value is not needed when running the local development server.
For theme specific configuration options, see the theme site.
For further theme customization, see Customize a Theme. Output will be in. Step 1: Install Hugo brew install hugo. Unix absLangURL absURL after anchorize append apply base64 chomp complement cond countrunes countwords dateFormat default delimit dict echoParam emojify eq errorf and warnf fileExists findRE first float ge getenv group gt hasPrefix highlight htmlEscape htmlUnescape hugo humanize i18n Image Functions in index int intersect isset jsonify lang.
Merge lang. NumFmt last le lower lt markdownify Math md5 merge ne now os. Stat partialCached path. Base path. Dir path. Ext path. Join path. Split plainify pluralize print printf println querify range readDir readFile ref reflect. IsMap reflect. HasSuffix strings. Repeat strings. RuneCount strings.
TrimLeft strings. TrimPrefix strings. TrimRight strings. TrimSuffix substr symdiff templates. Exists time title transform. Unmarshal trim truncate union uniq upper urlize urls.You can find the demo site in action here and the source here. You can now go ahead an edit the newly created file under the content directory. The above example demonstrates how to create a pages and posts. However, you may want at times want to override this behavior and create a standalone page like an about page or projects page or have more control of what content is listed from within the directory.
In such cases, you can override the default behavior by placing an index. The provided config.
Configure it your way! Adding it to your public will expose your data to the public. This is irreversible. Licensed under the MIT License. Hugo Themes. Download Demo Homepage. Goa Goa is a clean, simple and minimalist theme for blogs and personal websites. Demo You can find the demo site in action here and the source here. Organizing pages The above example demonstrates how to create a pages and posts. This allows you to disable page meta information from being displayed.
For example, this setting is disabled here and enabled here. Enables or disable comments. Configuration The provided config. Basic Configuration These are site wide configuration parameters that are used by this template. Enables or Disable building drafts when hugo is run. More Information. Erlich Bachman. Hugo Built-in Features These are features that hugo provides and are used by this template. Site Settings [params] These are settings that are specific to this theme. This field supports markdown.
Startup Guru Extraordinaire. Now Pied Piper.
Previously Hacker Hostel, Bachmanity and Aviato. It's Fleventy-five. Jan 2, Site Meta Settings [params. Simple minimalist theme.You want to help and inspire people, influence them or touch the hearts of your readers.
There are a ton of publishing options available—which one is going to work best for you? Your trusted guide through the labyrinth of publishing.
Discover what we can do for you and your book. Book publishing can be a very frustrating and disheartening experience. Hugo House has learned how the publishing process works through many years of trial and error.
Find out more. Collaboration is the key to successful publishing. It takes expert editors, award-winning designers, top-of-the-line printing, wide distribution and effective, tailored marketing to make your book a sought-after commodity. All Hugo House authors win because they learn how to do it right. We accept first time authors as well as those published authors looking for a publisher who is truly dedicated to them and their book.
We are committed to helping you through all the aspects of the publishing process—but you remain in creative control from start to finish. Submit your book proposal Hugo House Publishers, Ltd. Anyone can put words on paper and call it a book. A quality book represents you and your vision and should serve you well. We partner with reputable companies who share our vision. The Hugo House mission is to publish books that uplift the culture by promoting sanity on this planet.
Many of our books win awards because we produce high-quality books that create the positive effects our authors desire. Authors want to sell books. To that end, our distribution systems are global, and we work with authors to build a platform of willing buyers. We are audience focused, which means we pay attention to the message the reader will respond to and help our authors disseminate that message as widely as possible.
Hugo House is always accepting authors who are willing to work with us to create stellar books that are enjoyable reads.
There are millions of titles published every year. We want authors who aspire to rise above the mediocre, so together we can do great things.Hugo is considered to be one of the greatest and best-known French writers.
Hugo was at the forefront of the Romantic literary movement with his play Cromwell and drama Hernani. He produced more than 4, drawings in his lifetime, and campaigned for social causes such as the abolition of capital punishment. Though a committed royalist when he was young, Hugo's views changed as the decades passed, and he became a passionate supporter of republicanism ; his work touches upon most of the political and social issues and the artistic trends of his time.
His legacy has been honoured in many ways, including his portrait being placed on French currency. Hugo's childhood was a period of national political turmoil. Because Hugo's father was an officer, the family moved frequently and Hugo learned much from these travels. On a childhood family trip to NaplesHugo saw the vast Alpine passes and the snowy peaks, the magnificently blue Mediterranean, and Rome during its festivities. They stayed in Naples for a few months and then headed back to Paris.
Thereafter she dominated Hugo's education and upbringing. As a result, Hugo's early work in poetry and fiction reflect her passionate devotion to both king and faith. It was only later, during the events leading up to France's Revolutionthat he began to rebel against his Catholic Royalist education and instead acted as a champion to Republicanism and Freethought.
On 4 September, she drowned in the Seine at Villequierpulled down by her heavy skirts when a boat overturned. Her young husband also died trying to save her. I will see that instant until I die, that instant—too much for tears!
I don't have her any more! He wrote many poems afterwards about his daughter's life and death, and at least one biographer claims he never completely recovered from it. After leaving France, Hugo lived in Brussels briefly inand then moved to the Channel Islands, first to Jersey — and then to the smaller island of Guernsey inwhere he stayed until Napoleon III's fall from power in Although Napoleon III proclaimed a general amnesty inunder which Hugo could have safely returned to France, the author stayed in exile, only returning when Napoleon III was forced from power as a result of the French defeat in the Franco-Prussian War in After the Siege of Paris from toHugo lived again in Guernsey from toand then finally returned to France for the remainder of his life.
Inafter the death of his son Charles, Hugo took custody of his grandchildren Jeanne and Georges-Victor. Hugo published his first novel the year following his marriage Han d'Islande, and his second three years later Bug-Jargal In his youth, Hugo resolved to be " Chateaubriand or nothing", and his life would come to parallel that of his predecessor in many ways.
Like ChateaubriandHugo furthered the cause of Romanticism, became involved in politics though mostly as a champion of Republicanismand was forced into exile due to his political stances. The precocious passion and eloquence of Hugo's early work brought success and fame at an early age.
Though the poems were admired for their spontaneous fervour and fluency, the collection that followed four years later in Odes et Ballades revealed Hugo to be a great poet, a natural master of lyric and creative song. Victor Hugo's first mature work of fiction was first published in February by Charles Gosselin without the author's name and reflected the acute social conscience that would infuse his later work. Hugo became the figurehead of the Romantic literary movement with the plays Cromwell and Hernani One of the effects of the novel was to shame the City of Paris into restoring the much-neglected Cathedral of Notre Damewhich was attracting thousands of tourists who had read the popular novel.
The book also inspired a renewed appreciation for pre-Renaissance buildings, which thereafter began to be actively preserved. Hugo was acutely aware of the quality of the novel, as evidenced in a letter he wrote to his publisher, Albert Lacroix, on 23 March"My conviction is that this book is going to be one of the peaks, if not the crowning point of my work. The Belgian publishing house Lacroix and Verboeckhoven undertook a marketing campaign unusual for the time, issuing press releases about the work a full six months before the launch.However, you can change this value by specifying a different publishDir in your site configuration.
The permalinks option in your site configuration allows you to adjust the directory paths i. RelPermalink will honor the adjustments made as a result of the mappings in this option. For example, if one of your sections is called posts and you want to adjust the canonical path to be hierarchical based on the year, month, and post title, you could set up the following configurations in YAML and TOML, respectively.
If the standard date-based permalink configuration does not meet your needs, you can also format URL segments using Go time formatting directives.
For example, a URL structure with two digit years and month and day digits without zero padding can be accomplished with:. You can also configure permalinks of taxonomies with the same syntax, by using the plural form of the taxonomy instead of the section. You will probably only want to use the configuration values :slug or :title. The following is a list of values that can be used in a permalink definition in your site config file.
You can create an aliases field in the front matter of your new my-awesome-blog-post. Now when you visit any of the locations specified in aliases—i. For example, a visitor to example. On multilingual siteseach translation of a post can have unique aliases. To use the same alias across multiple languages, prefix it with the language code. From Hugo 0. When aliases are specified, Hugo creates a directory to match the alias entry.
Inside the directory, Hugo creates an. Assuming a baseURL of example. You may customize this alias page by creating an alias. In this case, the data passed to the template is. No non-standard server-side configuration is required for these pretty URLs to work. If you want a specific piece of content to have an exact URL, you can specify this in the front matter under the url key.
The following are examples of the same content directory and what the eventual URL structure will be when Hugo runs with its default behavior.
See Content Organization for more details on paths. By default, all relative URLs encountered in the input are left unmodified, e. The canonifyURLs field in your site config has a default value of false. Benefits of canonicalization include fixing all URLs to be absolute, which may aid with some parsing tasks. Note, however, that all modern browsers handle this on the client without issue.
Benefits of non-canonicalization include being able to have scheme-relative resource inclusion; e. To find out the current value of canonifyURLs for your website, you may use the handy hugo config command added in v0. In addition to specifying permalink values in your site configuration for different content sections, Hugo provides even more granular control for individual pieces of content.
Both slug and url can be defined in individual front matter. For more information on content destinations at build time, see Content Organization.