GoHugo: time to move on to modules

Simple scheme to switch to modules in a Hugo Academic based site under Linux Mint

Hugo Academic: from Theme to Modules

I have a test site in Hugo environment with Academic theme.

The test site is hosted in GitHub.

Since September 2020, the structure of the theme has changed and is now controlled through modules.

This step has also been accompanied by a new name of the site building system: the new name is Wowchemy.

I have found that the official guidelines for converting previous sites are a bit concise, especially for those who are not coders.

Here is the outline that I have followed in order to complete with success the passage under a Linux Mint operating system.

Prerequisite: Go installation

In the classic Academic Hugo theme it wasn’t necessary to have a Go version working into the operating system.

Now it’s necessary.

Then the prerequisite is to install a Go version: go to Golang.org and follow the instructions (dowload the newest release, extract it and adjust the PATH).

The outline: from Academic to Wowchemy

Now you can convert your previuos Academic site to a Wowchemy site, following these steps:

  • Place the cursor in the local folder where you store the site (i.e. cd yoursitelocalfolder)
  • Remove or de-init the Academic submodules: the fastest solution is the second one:
    • rm -rf themes/academic (which means: force the folder removal)
    • rm -f .gitmodules (which means: force the .gitmodules file removal)
  • Trasform your site in a module by typing: hugo mod init github.com/(insert your Github username)/(insert your GitHub projectname)
  • Open che config.toml file but be careful that in Academic you will note find it in the root folder but in the config/_defaultsubfolder and add the following code:
[module]
[[module.imports]]
path = "github.com/wowchemy/wowchemy-hugo-modules/wowchemy"
  • Update the modules with $ hugo mod get -u and everything should be fine.

Now you can enjoy your new Wowchemy modular site by typing the classic hugo serve command and push everything in GitHub with the usual Git procedure.

Thank you for your attention.

Originally posted at My Netbook Home

Comments

Post a Comment

Popular posts from this blog

Vim: searching for text containing a slash or a question mark

Vim: searching for text containing a slash or a question mark Vim: the search command To activate a text search in Vim, press one of the following trigger keys in your keyboard: the slash "/" key (do not confuse with the back-slash "\" key) the question mark key. By pressing the slash "/" key will activate a forward search. By pressing the question mark "/" key will activate a backward search. To move the cursor to the results in your document, press the "n" key (mnemonic for “ next ”). To invert the direction of the cursor, press the "N" key, (“upper n”) . What about if you need to search for a slash or a question mark , i.e. the same trigger characters , in your document? You can prepend the Escape character to the trigger key. The Escape character The Escape character is the back-slash key: "\" . Just an example: if you need to forward search (then with / trigger k...
Read more

Vim: Cut, Copy and Paste to and from the system clipboard

Image
Vim: Cut, Copy and Paste to and from the system clipboard Table of Contents 1. Cut, Copy and Paste using the computer keyboard 2. Vim and the clipboard 3. From Vim to the Clipboard 4. From the Clipboard to Vim 5. Some key shortcuts in gVim Figure 1: Vim 1 Cut, Copy and Paste using the computer keyboard Everybody knows how to use the keyboard combinations Ctrl-c , Ctrl-x , and Ctrl-v in Windows and Linux (or Cmd-c , Cmd-x and Cmd-v in macOS) to copy, cut and paste text across applications. Many think that those combinations are universal and work with any application. But Vim and gVim are different, they use another system to exchange information with the rest of the IT world. For example, in Vim under Linux, the key combination Ctrl-v corresponds to the visual block function and does not affect the pasting text. I wrote this article to remind me, as a non-programmer, the key combinations to be used in the Vim world to sha...
Read more