Awesome
Test-Hugo-2-Gopher-and-Gemini
Testbed for the Hugo-2-Gopher-and-Gemini repository. The test consist of few hugo theme's examples that will be modified to test the Hugo-2-Gopher-and-Gemini
project.
This is a companion repository to the Hugo-2-Gopher-and-Gemini repository for testing purposes. The other companion repository is the Gopher-and-Gemini-Walker used to navigate generated sites before deploying them.
Introduction
The tests will consist of examples from hugo themes. Each one will be named test-<theme name>. Each test will be enhanced to test parts of the hugo2gg.py
program capabilities.
To execute the tests, open a command line window at the base of this repository and execute ./test.sh
. That will generate a log in the logs directory.
List of tests
Entries in this list of Hugo themes have been selected almost randomly. The only two criteria used were a single language (as hugo2gg.py
does not support multilingual) and the ability to run hugo to the sampleSite with minimal changes to the config.toml
. The exampleSite
has been modified to test multiple generation strategies. However, original content has not been removed. Only either modified (mainly front matter) or new content added.
- Test-hugo-theme-console in github repository by Marcin Mierzejewski.
- Test-hugo-researcher in github repository by Olivier Roques.
- Test-hugo-blog-jeffprod in github repository by JeffProd.
Process to add a new test
For each test, the following basic process has been followed:
- Executed
hugo new site test-hugo-<theme>
- From the new site executed
git submodule add https://github.com/<user>/<theme> themes/test-hugo-<theme>
(as indicated on the installation instructions. - Copied
test-hugo-<theme>/themes/<theme/exampleSite/*
totest-hugo-<theme>
merging directories and overwriting files. - Minimal editing of the
config.toml
file. - Executed
hugo
- If necessary changed the
config.toml
file and executedhugo
again. If the failed or required settings accounts, etc. then removedtest-hugo-<theme>
and tried a new theme. - Create an empty folder called
layouts-gg
. - Copy and modify the
config-gg.toml
files. To test multiple options, we will create several configs calledconfig-gga.toml
,config-ggb.toml
,config-ggc.toml
, etc. - Create a test script (
test.sh
) for this test.