Calligraphy is a theme for Hugo static site generator focused on the beauty of it's content.
There are two different methods to install the theme depending on how you plan on using it.
I want to use this theme and might want to contribute to it.
Navigate to the root directory of your site and do the following:
git clone https://github.com/pacollins/calligraphy.git themes/calligraphy
I want to use this theme, but I have no plans to contribute or make a pull request.
Navigate to the root directory of your site and do the following:
git submodule add https://github.com/pacollins/calligraphy.git themes/calligraphy
git submodule update --init --recursive
You should now be able to navigate to themes/calligraphy
and see all of the theme files.
To update your site to the current version of the theme, navigate to the root directory and do the following:
git submodule update --remote --merge
If you need to customize any aspect of the theme for personal use, simply create a duplicate file at the root directory. Note: You do not need to edit the theme files to customize theme. Refer to the Hugo documentation related lookup order.
For example, if you wanted to change the template for the header (<my-project>/themes/layouts/partials/site/header.html
) you would create a new file at <my-project>/layouts/partials/site/header.html
and base it off of the theme file. Hugo will then use your file instead of the theme file. This is the proper way to adjust files for personal use so that you do not make your site incompatible with future versions of the theme.
Within the calligraphy
folder, you will find another folder called exampleSite
This folder is what is used to build the demo and should provide you with an example of how to structure your site files.
To see a live version of your site locally, use the following command:
hugo server
Hugo will build your site and host a server locally. You can view this live at localhost:1313.
Calligraphy is a theme created by Patrick A Collins for Hugo. Inspired by its namesake, the theme aims to provide a simple canvas that is elegant and ensures high readability for all visitors.
Please also refer to the project contributors list for everyone that has directly contributed to this theme.
This theme is released under the MIT License. Please read the license for more information.