Why

• When working with archetypes, the CLI expects us to mention the exact file name we want to create, instead of converting a provided string into a valid file name.

• Inability to create a sequence of files (Example, creating an FAQ’s Markdown Page with faq-1.md, faq-2.md, faq-3.md file names). We’re expected to enter them manually each time.

• When working with projects that require us to create multiple markdown files, we can’t add more than the “title” field to our markdown files.

Features

• Enter a string with as many special characters, watcht them be converted into a suitable file name.

  Eg: “This new blog post I want to write!” in the command line would convert into “this-new-blog-post-i-want-to-write.md”.

• Enter the archetype you wish to enter, the script will check if the archetype exists. If it doesn’t exist, Hugo CLI will prompt you with an error.

• Create multiple markdown files and automatically populate the variables + content fields from a local CSV! (YAML format front matter only)

• (NEW) Lets you download files from a link into a specific path within your project and aassign the values into your .md file! (CSV Only)

• Lets you use a custom prefix CLI if you’re using any other CLI that handshakes with hugo. Only changes prefix that could replace the “hugo new” function

• Enter the amount of files you want to create in sequence, the script will create everything.

• Lets you use a custom separator if you’d like something apart from ‘-‘ hyphens in your file name.

• Colour codes the output (ft. colorama) for you to differentiate between outputs.

Requirements

• Python 3.x

• Hugo CLI (Tested on 0.59.1)

• Archetype file within your project root/theme archetype folder.

How To Use (Normal)

1. Install Hugon:

   pip install hugon

2. cd Into your hugo project folder.

3. run the command:

   hugon -name "N3w F!le" -archetype "default" -sequence "5"

Syntax (Normal)

How To Use (Generate From CSV)

1. Create a ‘data.csv’ file in the root of your hugo site.

2. Enter all the required variable fields (along with the required compulsory fields) as columns on your first row, and populate to your hearts content.

3. Run command:

   hugon -csv yes

4. If you’d like to overwrite your files without being prompted (Risky) just pass ‘-overwrite true’ as an argument.:

   hugon -csv yes -overwrite true

Syntax (CSV)

Warning: Files would be modified the moment they’re made. Mistakes cannot be undone.

• Looking to add tags/taxonomies? Separate your values in the column with a “^;”

• Looking to values to your YAML without quotation marks? (Eg: true/false values) Prepend your value with “^”

• Need line breaks within your ‘content’ cell? Specify them with a ‘n’

• If you’re using the “path” key, note that the script would add the path into your front matter by ommiting the first folder. Eg: “static/img/ex.jpg” would be inserted as “img/ex”. If you’d like to retain the parent folder name in front matter, just add “?” to the beginning of the value in your CSV path field.

• View sample CSV attached within this repository for more information.

• Note:

  • Remember to remove any whitespace around your cell headings and values.

  • If the script doesn’t work as expected, please check your archetype keys for typos/spaces as well.

TO DO

• Adding option to input values from CSV. (Done!)

• Adding option to get image/file from a URL and downloading it straight into a specified folder. CSV Only. (Done!)

• Adding option to expand download functionality to allow for download of multiple files.

• TOML format support.

• Fixing typos and grammatical errors in code + this readme doc. (Never ending :( )

Credits

• Color support via Colarama.

• This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

0.1.7 (2020-08-01)

• Fixed Functionality:

  • CSV would now “continue” to next row instead of earlier “break”, if the values in the row are incorrect.

  • By default, path field in front matter would remove the first folder. (Eg: “static/img/ex.jpg” would be saved into the static folder, but inserted into front matter as “img/ex.jpg”)

  • You can still retain parent folder in your front matter by adding “?” to the beginning of your path.

• Tiny fixes and performance improvements.

0.1.6 (2019-12-27)

• Added new functionality:

  • CSV now allows you to download a single file into your project folder. Specify ‘da-’ suffix in the key column, and mention the anchor link in your values field. Might not work with restricted URLs.

  • Above functionality works only when you have a ‘path’ column specified with the name of the folder the file should go into, within the root of your project. Does not currently support downloading multiple files related to a single page.

• Added sample CSV link to help understand the above functionality and others better.

• Fixed typos and grammatical errors within the code and readme file. Oops!

• Added comment entries to a few functions for easier readability.

• Homogenized the method used to combine folder paths, making the script function more predictably cross platform.

• Cleaned up the terminal, and added closing credits (script name) to show up after execution.

• Updated readme to make it easier to understand.

• Renamed “images” folder (in the github repository) to “sample”.

0.1.5 (2019-12-26)

• Fixed bug that stopped you from specifying a file name with separators within the name.

• Updated display screenshot to reflect the above change.

• Added do-it-live.sh file for ease of screenshot creation. Not added the same into dependencies.

0.1.4 (2019-12-13)

• Fixed bug that stopped you from specifying a sequence.

• Fixed content replacement (CSV) issue that duplicated the section instead of replacing it.

• Pushed non-hugo CLI messages to colorama function for easy readability.

• Added pretty ‘horizontal line breaks’ after any code is executed. (Resizes the next output to your existing terminal size).

• Other bug fixes and optimizations.

0.1.1 (2019-12-13)

• Added CSV support for dynamic YAML markdown file generation.

0.1.0 (2019-12-06)

• First release on PyPI.