From 1d783931d629bef2bff923ddad71355d237637a9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=B6ren=20Weber?= Date: Mon, 22 Apr 2024 21:12:53 +0200 Subject: [PATCH] docs: fix oddities in the installation tutorial #840 --- .../content/basics/installation/_index.en.md | 105 ++++++++++-------- .../content/basics/installation/chapter.png | Bin 15576 -> 0 bytes 2 files changed, 57 insertions(+), 48 deletions(-) delete mode 100644 exampleSite/content/basics/installation/chapter.png diff --git a/exampleSite/content/basics/installation/_index.en.md b/exampleSite/content/basics/installation/_index.en.md index b441ed4243..936b5e7d84 100644 --- a/exampleSite/content/basics/installation/_index.en.md +++ b/exampleSite/content/basics/installation/_index.en.md @@ -12,9 +12,9 @@ The following tutorial leads you through the steps of creating a first, minimal You don't need to edit any files besides your `hugo.toml` and only need to execute the commands in the given order. {{% /notice %}} -## Create your project +## Create your Project -Hugo provides a `new` command to create a new website: +Hugo provides the `new` command to create a new website: ````shell hugo new site my-new-site @@ -28,31 +28,49 @@ cd my-new-site Every upcoming command will be executed from inside your new site's root. -## Install the theme +## Install the Theme -### From Download +### Downloading as Archive -You can [download the theme as .zip](https://github.com/McShelby/hugo-theme-relearn/archive/main.zip) file and extract it into them `themes/hugo-theme-relearn` directory. +You can [download the theme as .zip archive](https://github.com/McShelby/hugo-theme-relearn/archive/main.zip) and extract its content into them `themes/hugo-theme-relearn` directory. -### With Hugo's Module System +Afterwards add this at the end of your `hugo.toml`. -Install the Relearn theme by following [this documentation](https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme) using Hugo's module system. +{{< multiconfig file=hugo >}} +theme = "hugo-theme-relearn" +{{< /multiconfig >}} -This theme's repository is: https://github.com/McShelby/hugo-theme-relearn.git +### Using Hugo's Module System -### Using Git or Git Submodules +You can install the Relearn theme by following [the standard documentation](https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme) using Hugo's module system: -If you install the theme from your git repository or GitHub, you have several options. +````shell +hugo mod init example.com +```` -If you use the `head` of the `main` branch, you are using the development version. Usually it is fully functional but can break from time to time. We try to fix newly introduced bugs in this version as soon as possible. +Afterwards add this at the end of your `hugo.toml`. -Additionally you can checkout one of the tagged versions. These tagged versions correspond to an official [releases from the GitHub repository](https://github.com/McShelby/hugo-theme-relearn/releases). +{{< multiconfig file=hugo >}} +[module] + [[module.imports]] + path = 'github.com/McShelby/hugo-theme-relearn' +{{< /multiconfig >}} -Besides the usual version tags (eg `1.2.3`) there are also tags for the main version (eg. `1.2.x`), major version (eg. `1.x`) and the latest (just `x`) released version making it easier for you to pin the theme to a certain version. +### Using Git Submodules -## Basic Configuration +If you plan to store your project in a git repository you can create one with: -When building the website, you can set a theme by using `--theme` option. However, we suggest you modify the configuration file `hugo.toml` and set the theme as the default. +````shell +git init +```` + +Now add the theme as a submodule by: + +````shell +git submodule add https://github.com/McShelby/hugo-theme-relearn.git themes/hugo-theme-relearn +```` + +Afterwards add this at the end of your `hugo.toml`. {{< multiconfig file=hugo >}} theme = "hugo-theme-relearn" @@ -60,70 +78,61 @@ theme = "hugo-theme-relearn" ## Create your Home Page -If you don't create a home page, yet, the theme will generate a placeholder text with instructions how to proceed. +If you don't create a home page, yet, the theme will generate a placeholder text with instructions on how to proceed. -Start your journey by filling the home page with content +Start your journey by creating a home page: ````shell hugo new --kind home _index.md ```` -By opening the given file, you should see the property `archetype=home` on top, meaning this page is a home page. The Relearn theme provides [some archetypes](cont/archetypes) to create those skeleton files for your website. - -Obviously you better should change the page's content. +The newly created home page `content/_index.md` is empty and you obviously should add some meaningful content. ## Create your First Chapter Page -Chapters are pages that contain other child pages. It has a special layout style and usually just contains the _title_ and a _brief abstract_ of the section. +Chapters are meant to be top level pages that contain other child pages. They have a special layout style and often just contain the _title_ and a _brief abstract_ of the section. -````md -# Basics - -Discover what this Hugo theme is all about and the core concepts behind it. -```` - -renders as - -![A Chapter](chapter.png?width=60pc) - -Begin by creating your first chapter page with the following command: +Now create your first chapter page with the following command: ````shell hugo new --kind chapter basics/_index.md ```` -By opening the given file, you should see the property `archetype=chapter` on top, meaning this page is a _chapter_. - -The `weight` number will be used to generate the subtitle of the chapter page, set the number to a consecutive value starting at 1 for each new chapter level. +When opening the newly created file `content/basics/_index.md`, you should see the `weight` frontmatter with a number. This will be used to generate the subtitle of the chapter page, and should be set to a consecutive value starting at `1` for each chapter level. ## Create your First Content Pages -Then, create content pages inside the previously created chapter. Here are two ways to create content in the chapter: +Then create content pages inside the previously created chapter. Here are three ways to create content in the chapter: ````shell -hugo new basics/first-content.md -hugo new basics/second-content/_index.md +hugo new basics/first-content/_index.md +hugo new basics/second-content/index.md +hugo new basics/third-content.md ```` Feel free to edit those files by adding some sample content and replacing the `title` value in the beginning of the files. -## Launching the Website Locally +{{% notice note%}} +Please note that Hugo overrides the default archetype template coming with this theme when using `hugo new site my-new-site`. To actually see your page later, you have to remove the `draft=true` from the page's frontmatter. +{{% /notice %}} -Launch by using the following command: +## Testing your Website Locally + +Launch your new web site by using the following command: ````shell hugo serve ```` -Go to `http://localhost:1313` +Go to [`http://localhost:1313`](http://localhost:1313) in your browser. -You should notice three things: +You should notice a few things: -1. The home page contains some basic text. -2. You have a left-side **Basics** menu, containing two submenus with names equal to the `title` properties in the previously created files. -3. When you run `hugo serve` your page refreshes automatically when you change a content page. Neat! +1. The home page contains your provided text. +2. You have the menu **Basics** in the sidebar. Clicking on it reveals three submenus with names equal to the `title` properties in the previously created content pages. +3. While you are running `hugo serve` your page refreshes automatically when you change a content page. Neat! -## Build the Website +## Build and Deploy your Website When your site is ready to deploy, run the following command: @@ -131,6 +140,6 @@ When your site is ready to deploy, run the following command: hugo ```` -A `public` folder will be generated, containing all content and assets for your website. It can now be deployed on any web server. +A `public` directory will be generated, containing all content and assets for your web site. -Now it's time to deploy your page by simply uploading your project to some web server or by using one of [Hugo's many deployment options](https://gohugo.io/hosting-and-deployment/). +It now can be deployed to any web server by simply uploading its contents or you can check out one of [Hugo's many other deployment options](https://gohugo.io/hosting-and-deployment/). diff --git a/exampleSite/content/basics/installation/chapter.png b/exampleSite/content/basics/installation/chapter.png deleted file mode 100644 index ba78e5d58d852b101b6529daca72d2793730e8ba..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15576 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 R30fd?%EInM$uAxW{}<)sFfsrD