From ad4a3ccc1c256870bab13259d33c8e463c190ea5 Mon Sep 17 00:00:00 2001 From: Andreas Deininger Date: Sat, 6 Jan 2024 13:47:15 +0100 Subject: [PATCH] Bring example site up to date --- .github/{demo_config.toml => demo_hugo.toml} | 0 .github/workflows/gh-pages.yml | 10 +++--- .gitignore | 2 ++ README.md | 4 +-- exampleSite/content/chapter3/_index.md | 2 +- exampleSite/content/chapter4/_index.md | 2 +- exampleSite/content/getting-started/_index.md | 2 +- .../content/getting-started/configuration.md | 4 +-- .../content/getting-started/installation.md | 4 +-- .../content/post/creating-a-new-theme.md | 36 +++++++++---------- exampleSite/content/post/goisforlovers.md | 6 ++-- exampleSite/content/post/hugoisforlovers.md | 4 +-- .../content/post/migrate-from-jekyll.md | 14 ++++---- ...n-shortcodes.md => built-in-shortcodes.md} | 2 +- exampleSite/{config.toml => hugo.toml} | 0 15 files changed, 47 insertions(+), 45 deletions(-) rename .github/{demo_config.toml => demo_hugo.toml} (100%) rename exampleSite/content/sample/{build-in-shortcodes.md => built-in-shortcodes.md} (93%) rename exampleSite/{config.toml => hugo.toml} (100%) diff --git a/.github/demo_config.toml b/.github/demo_hugo.toml similarity index 100% rename from .github/demo_config.toml rename to .github/demo_hugo.toml diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index c0e9e20..0966399 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -1,4 +1,4 @@ -name: Publish demo site to Github Pages +name: Publish demo site to GitHub Pages on: push: @@ -11,18 +11,18 @@ jobs: timeout-minutes: 30 steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v4 - name: Install Hugo uses: peaceiris/actions-hugo@v2 with: - hugo-version: '0.101.0' + hugo-version: '0.121.2' extended: true - name: Build demo website to public directory run: | cd ./exampleSite - hugo --config ../.github/demo_config.toml --themesDir ../.. --minify + hugo --config ../.github/demo_hugo.toml --themesDir ../.. --minify - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v3 @@ -30,4 +30,4 @@ jobs: personal_token: ${{ secrets.GITHUB_TOKEN }} publish_branch: gh-pages publish_dir: ./exampleSite/public - commit_message: 'deploy to GitHub Pages via GitHub Actions' + commit_message: 'Deploy to GitHub Pages via GitHub Actions' diff --git a/.gitignore b/.gitignore index 9daa824..08e17e7 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,4 @@ .DS_Store node_modules +public +.hugo_build.lock \ No newline at end of file diff --git a/README.md b/README.md index 4186207..d44df4e 100644 --- a/README.md +++ b/README.md @@ -91,9 +91,9 @@ git clone https://github.com/thingsym/hugo-theme-techdoc.git ### Configure -You may specify options in config.toml (or config.yaml/config.json) of your site to make use of this theme's features. +You may specify options in hugo.toml (or hugo.yaml/hugo.json) of your site to make use of this theme's features. -For an example of `config.toml`, [config.toml](https://github.com/thingsym/hugo-theme-techdoc/blob/master/exampleSite/config.toml) in exampleSite. +For an example of `hugo.toml`, [hugo.toml](https://github.com/thingsym/hugo-theme-techdoc/blob/master/exampleSite/hugo.toml) in exampleSite. ### Update Hugo theme for git submodule diff --git a/exampleSite/content/chapter3/_index.md b/exampleSite/content/chapter3/_index.md index 4784e19..3a8cce5 100644 --- a/exampleSite/content/chapter3/_index.md +++ b/exampleSite/content/chapter3/_index.md @@ -6,7 +6,7 @@ weight: 40 --- {{% panel status="primary" title="Note" icon="far fa-lightbulb" %}} -The document hierarchy is unlimite. +The document hierarchy is unlimited. {{% /panel %}} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. diff --git a/exampleSite/content/chapter4/_index.md b/exampleSite/content/chapter4/_index.md index 02c755b..74edf2d 100644 --- a/exampleSite/content/chapter4/_index.md +++ b/exampleSite/content/chapter4/_index.md @@ -6,7 +6,7 @@ weight: 50 --- {{% panel status="primary" title="Note" icon="far fa-lightbulb" %}} -The document hierarchy is unlimite. +The document hierarchy is unlimited. It also means that the menu levels is unlimited levels. The menu levels has up to 5 levels of indentation. After that there is no indentation. diff --git a/exampleSite/content/getting-started/_index.md b/exampleSite/content/getting-started/_index.md index 9bb7e22..e73759d 100644 --- a/exampleSite/content/getting-started/_index.md +++ b/exampleSite/content/getting-started/_index.md @@ -17,6 +17,6 @@ Download Hugo theme, configure, preview site ... ## [Configuration](./configuration) -You may specify options in config.toml (or config.yaml/config.json) of your site to make use of this theme's features. +You may specify options in hugo.toml (or hugo.yaml/hugo.json) of your site to make use of this theme's features. ## [Screenshot](./screenshot) diff --git a/exampleSite/content/getting-started/configuration.md b/exampleSite/content/getting-started/configuration.md index a17043b..7b320d3 100644 --- a/exampleSite/content/getting-started/configuration.md +++ b/exampleSite/content/getting-started/configuration.md @@ -6,9 +6,9 @@ draft: false weight: 20 --- -You may specify options in config.toml (or config.yaml/config.json) of your site to make use of this theme’s features. +You may specify options in hugo.toml (or hugo.yaml/hugo.json) of your site to make use of this theme’s features. -For an example of `config.toml`, see [config.toml](https://github.com/thingsym/hugo-theme-techdoc/blob/master/exampleSite/config.toml) in exampleSite. +For an example of `hugo.toml`, see [hugo.toml](https://github.com/thingsym/hugo-theme-techdoc/blob/master/exampleSite/hugo.toml) in exampleSite. ## Params diff --git a/exampleSite/content/getting-started/installation.md b/exampleSite/content/getting-started/installation.md index e6cd950..8f7e048 100644 --- a/exampleSite/content/getting-started/installation.md +++ b/exampleSite/content/getting-started/installation.md @@ -27,9 +27,9 @@ git clone https://github.com/thingsym/hugo-theme-techdoc.git ## Configure -You may specify options in config.toml (or config.yaml/config.json) of your site to make use of this theme's features. +You may specify options in hugo.toml (or hugo.yaml/hugo.json) of your site to make use of this theme's features. -For an example of `config.toml`, see [config.toml](https://github.com/thingsym/hugo-theme-techdoc/blob/master/exampleSite/config.toml) in exampleSite. +For an example of `hugo.toml`, see [hugo.toml](https://github.com/thingsym/hugo-theme-techdoc/blob/master/exampleSite/hugo.toml) in exampleSite. See [the Configuration documentation](../configuration/). diff --git a/exampleSite/content/post/creating-a-new-theme.md b/exampleSite/content/post/creating-a-new-theme.md index 9d6d2f7..fe0fa6b 100755 --- a/exampleSite/content/post/creating-a-new-theme.md +++ b/exampleSite/content/post/creating-a-new-theme.md @@ -129,7 +129,7 @@ total 8 drwxr-xr-x 7 quoha staff 238 Sep 29 16:49 . drwxr-xr-x 3 quoha staff 102 Sep 29 16:49 .. drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 archetypes --rw-r--r-- 1 quoha staff 82 Sep 29 16:49 config.toml +-rw-r--r-- 1 quoha staff 82 Sep 29 16:49 hugo.toml drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 content drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 layouts drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 static @@ -146,7 +146,7 @@ Running the `hugo` command with no options will read all the available content a ``` $ hugo --verbose -INFO: 2014/09/29 Using config file: config.toml +INFO: 2014/09/29 Using config file: hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ WARN: 2014/09/29 Unable to locate layout: [index.html _default/list.html _default/single.html] WARN: 2014/09/29 Unable to locate layout: [404.html] @@ -167,7 +167,7 @@ We can verify that the command worked by looking at the directory again. $ ls -l total 8 drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 archetypes --rw-r--r-- 1 quoha staff 82 Sep 29 16:49 config.toml +-rw-r--r-- 1 quoha staff 82 Sep 29 16:49 hugo.toml drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 content drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 layouts drwxr-xr-x 4 quoha staff 136 Sep 29 17:02 public @@ -195,7 +195,7 @@ Verify that you can run the built-in web server. It will dramatically shorten yo ``` $ hugo server --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ WARN: 2014/09/29 Unable to locate layout: [index.html _default/list.html _default/single.html] WARN: 2014/09/29 Unable to locate layout: [404.html] @@ -253,7 +253,7 @@ $ hugo new theme zafta $ ls -l total 8 drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 archetypes --rw-r--r-- 1 quoha staff 82 Sep 29 16:49 config.toml +-rw-r--r-- 1 quoha staff 82 Sep 29 16:49 hugo.toml drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 content drwxr-xr-x 2 quoha staff 68 Sep 29 16:49 layouts drwxr-xr-x 4 quoha staff 136 Sep 29 17:02 public @@ -311,7 +311,7 @@ Now that we've got a theme to work with, it's a good idea to add the theme name Edit the file to add the theme, add a title for the site, and specify that all of our content will use the TOML format. ``` -$ vi config.toml +$ vi hugo.toml theme = "zafta" baseurl = "" languageCode = "en-us" @@ -328,7 +328,7 @@ Now that we have an empty theme, let's generate the site again. ``` $ hugo --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html] @@ -450,7 +450,7 @@ Here's sample output showing Hugo detecting a change to the template for the hom ``` $ rm -rf public $ hugo server --watch --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html] @@ -507,7 +507,7 @@ Build the web site and then verify the results. ``` $ hugo --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html] @@ -560,7 +560,7 @@ Hugo has a command to generate a skeleton post, just like it does for sites and ``` $ hugo --verbose new post/first.md -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 attempting to create post/first.md of post INFO: 2014/09/29 curpath: /Users/quoha/Sites/zafta/themes/zafta/archetypes/default.md ERROR: 2014/09/29 Unable to Cast to map[string]interface{} @@ -586,14 +586,14 @@ $ find themes/zafta/archetypes -type f | xargs ls -l -rw-r--r-- 1 quoha staff 51 Sep 29 21:54 themes/zafta/archetypes/post.md $ hugo --verbose new post/first.md -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 attempting to create post/first.md of post INFO: 2014/09/29 curpath: /Users/quoha/Sites/zafta/themes/zafta/archetypes/post.md INFO: 2014/09/29 creating /Users/quoha/Sites/zafta/content/post/first.md /Users/quoha/Sites/zafta/content/post/first.md created $ hugo --verbose new post/second.md -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 attempting to create post/second.md of post INFO: 2014/09/29 curpath: /Users/quoha/Sites/zafta/themes/zafta/archetypes/post.md INFO: 2014/09/29 creating /Users/quoha/Sites/zafta/content/post/second.md @@ -634,7 +634,7 @@ Build the web site and then verify the results. ``` $ rm -rf public $ hugo --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 found taxonomies: map[string]string{"category":"categories", "tag":"tags"} @@ -707,7 +707,7 @@ Build the web site and then verify the results. ``` $ rm -rf public $ hugo --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 found taxonomies: map[string]string{"tag":"tags", "category":"categories"} @@ -784,7 +784,7 @@ Build the web site and verify the results. ``` $ rm -rf public $ hugo --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 found taxonomies: map[string]string{"tag":"tags", "category":"categories"} @@ -853,7 +853,7 @@ Build the web site and verify the results. ``` $ rm -rf public $ hugo --verbose -INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml +INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/hugo.toml INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/ INFO: 2014/09/29 found taxonomies: map[string]string{"tag":"tags", "category":"categories"} @@ -992,7 +992,7 @@ $ find public -name '*.html' | xargs ls -l Knowing that hugo is using the slug to generate the file name, the simplest solution is to change the slug. Let's do it the hard way and change the permalink in the configuration file. ``` -$ vi config.toml +$ vi hugo.toml [permalinks] page = "/:title/" about = "/:filename/" @@ -1063,7 +1063,7 @@ $ vi themes/zafta/layouts/index.html :wq ``` -Generate the web site and verify the results. The title on the home page is now "your title here", which comes from the "title" variable in the config.toml file. +Generate the web site and verify the results. The title on the home page is now "your title here", which comes from the "title" variable in the hugo.toml file. ### Update the Default Single Template to Use the Partials diff --git a/exampleSite/content/post/goisforlovers.md b/exampleSite/content/post/goisforlovers.md index df125d8..11b2beb 100755 --- a/exampleSite/content/post/goisforlovers.md +++ b/exampleSite/content/post/goisforlovers.md @@ -69,7 +69,7 @@ Accessing the Page Parameter "bar" Each Go template has a struct (object) made available to it. In hugo each template is passed either a page or a node struct depending on which type of page you are rendering. More details are available on the -[variables](/layout/variables) page. +[variables](https://gohugo.io/quick-reference/methods/) page. A variable is accessed by referencing the variable name. @@ -86,7 +86,7 @@ Variables can also be defined and referenced. Go template ship with a few functions which provide basic functionality. The Go template system also provides a mechanism for applications to extend the available functions with their own. [Hugo template -functions](/layout/functions) provide some additional functionality we believe +functions](https://gohugo.io/functions/templates/) provide some additional functionality we believe are useful for building websites. Functions are called by using their name followed by the required parameters separated by spaces. Template functions cannot be added without recompiling hugo. @@ -259,7 +259,7 @@ you want to inside of your templates. ## Using Content (page) Parameters In each piece of content you can provide variables to be used by the -templates. This happens in the [front matter](/content/front-matter). +templates. This happens in the [front matter](https://gohugo.io/content-management/front-matter/). An example of this is used in this documentation site. Most of the pages benefit from having the table of contents provided. Sometimes the TOC just diff --git a/exampleSite/content/post/hugoisforlovers.md b/exampleSite/content/post/hugoisforlovers.md index 02bb509..ccffc1b 100755 --- a/exampleSite/content/post/hugoisforlovers.md +++ b/exampleSite/content/post/hugoisforlovers.md @@ -31,7 +31,7 @@ you are reading right now. Follow the following steps: - 1. Clone the [Hugo repository](http://github.com/spf13/hugo) + 1. Clone the [Hugo repository](https://github.com/gohugoio/hugo) 2. Go into the repo 3. Run hugo in server mode and build the docs 4. Open your browser to http://localhost:1313 @@ -64,7 +64,7 @@ Now we are going to run hugo again, but this time with hugo in watch mode. > Press ctrl+c to stop -Open your [favorite editor](http://vim.spf13.com) and change one of the source +Open your [favorite editor](https://vim.spf13.com) and change one of the source content pages. How about changing this very file to *fix the typo*. How about changing this very file to *fix the typo*. Content files are found in `docs/content/`. Unless otherwise specified, files diff --git a/exampleSite/content/post/migrate-from-jekyll.md b/exampleSite/content/post/migrate-from-jekyll.md index ffb1a06..c18ec4f 100755 --- a/exampleSite/content/post/migrate-from-jekyll.md +++ b/exampleSite/content/post/migrate-from-jekyll.md @@ -27,7 +27,7 @@ should become Additionally, you'll want any files that should reside at the root (such as `CNAME`) to be moved to `static`. ## Create your Hugo configuration file -Hugo can read your configuration as JSON, YAML or TOML. Hugo supports parameters custom configuration too. Refer to the [Hugo configuration documentation](/overview/configuration/) for details. +Hugo can read your configuration as JSON, YAML or TOML. Hugo supports parameters custom configuration too. Refer to the [Hugo configuration documentation](https://gohugo.io/getting-started/configuration/) for details. ## Set your configuration publish folder to `_site` The default is for Jekyll to publish to `_site` and for Hugo to publish to `public`. If, like me, you have [`_site` mapped to a git submodule on the `gh-pages` branch](http://blog.blindgaenger.net/generate_github_pages_in_a_submodule.html), you'll want to do one of two alternatives: @@ -47,12 +47,12 @@ The default is for Jekyll to publish to `_site` and for Hugo to publish to `publ } ## Convert Jekyll templates to Hugo templates -That's the bulk of the work right here. The documentation is your friend. You should refer to [Jekyll's template documentation](http://jekyllrb.com/docs/templates/) if you need to refresh your memory on how you built your blog and [Hugo's template](/layout/templates/) to learn Hugo's way. +That's the bulk of the work right here. The documentation is your friend. You should refer to [Jekyll's template documentation](https://jekyllrb.com/docs/templates/) if you need to refresh your memory on how you built your blog and [Hugo's template](https://gohugo.io/templates/) to learn Hugo's way. -As a single reference data point, converting my templates for [heyitsalex.net](http://heyitsalex.net/) took me no more than a few hours. +As a single reference data point, converting my templates for [heyitsalex.net](https://heyitsalex.net/) took me no more than a few hours. ## Convert Jekyll plugins to Hugo shortcodes -Jekyll has [plugins](http://jekyllrb.com/docs/plugins/); Hugo has [shortcodes](/doc/shortcodes/). It's fairly trivial to do a port. +Jekyll has [plugins](https://jekyllrb.com/docs/plugins/); Hugo has [shortcodes](https://gohugo.io/content-management/shortcodes/). It's fairly trivial to do a port. ### Implementation As an example, I was using a custom [`image_tag`](https://github.com/alexandre-normand/alexandre-normand/blob/74bb12036a71334fdb7dba84e073382fc06908ec/_plugins/image_tag.rb) plugin to generate figures with caption when running Jekyll. As I read about shortcodes, I found Hugo had a nice built-in shortcode that does exactly the same thing. @@ -137,11 +137,11 @@ is written as this Hugo shortcode: ### Usage I simply changed: - {% image full http://farm5.staticflickr.com/4136/4829260124_57712e570a_o_d.jpg "One of my favorite touristy-type photos. I secretly waited for the good light while we were "having fun" and took this. Only regret: a stupid pole in the top-left corner of the frame I had to clumsily get rid of at post-processing." ->http://www.flickr.com/photos/alexnormand/4829260124/in/set-72157624547713078/ %} + {% image full https://farm5.staticflickr.com/4136/4829260124_57712e570a_o_d.jpg "One of my favorite touristy-type photos. I secretly waited for the good light while we were "having fun" and took this. Only regret: a stupid pole in the top-left corner of the frame I had to clumsily get rid of at post-processing." ->https://www.flickr.com/photos/alexnormand/4829260124/in/set-72157624547713078/ %} to this (this example uses a slightly extended version named `fig`, different than the built-in `figure`): - {{%/* fig class="full" src="http://farm5.staticflickr.com/4136/4829260124_57712e570a_o_d.jpg" title="One of my favorite touristy-type photos. I secretly waited for the good light while we were having fun and took this. Only regret: a stupid pole in the top-left corner of the frame I had to clumsily get rid of at post-processing." link="http://www.flickr.com/photos/alexnormand/4829260124/in/set-72157624547713078/" */%}} + {{%/* fig class="full" src="https://farm5.staticflickr.com/4136/4829260124_57712e570a_o_d.jpg" title="One of my favorite touristy-type photos. I secretly waited for the good light while we were having fun and took this. Only regret: a stupid pole in the top-left corner of the frame I had to clumsily get rid of at post-processing." link="https://www.flickr.com/photos/alexnormand/4829260124/in/set-72157624547713078/" */%}} As a bonus, the shortcode named parameters are, arguably, more readable. @@ -153,4 +153,4 @@ Depending on the amount of customization that was done with each post with Jekyl You'll want to remove the Jekyll configuration at this point. If you have anything else that isn't used, delete it. ## A practical example in a diff -[Hey, it's Alex](http://heyitsalex.net/) was migrated in less than a _father-with-kids day_ from Jekyll to Hugo. You can see all the changes (and screw-ups) by looking at this [diff](https://github.com/alexandre-normand/alexandre-normand/compare/869d69435bd2665c3fbf5b5c78d4c22759d7613a...b7f6605b1265e83b4b81495423294208cc74d610). +[Hey, it's Alex](https://heyitsalex.net/) was migrated in less than a _father-with-kids day_ from Jekyll to Hugo. You can see all the changes (and screw-ups) by looking at this [diff](https://github.com/alexandre-normand/alexandre-normand/compare/869d69435bd2665c3fbf5b5c78d4c22759d7613a...b7f6605b1265e83b4b81495423294208cc74d610). diff --git a/exampleSite/content/sample/build-in-shortcodes.md b/exampleSite/content/sample/built-in-shortcodes.md similarity index 93% rename from exampleSite/content/sample/build-in-shortcodes.md rename to exampleSite/content/sample/built-in-shortcodes.md index 403a8a1..aa876a2 100644 --- a/exampleSite/content/sample/build-in-shortcodes.md +++ b/exampleSite/content/sample/built-in-shortcodes.md @@ -32,7 +32,7 @@ See https://gohugo.io/content-management/shortcodes/#use-hugos-built-in-shortcod ## tweet -{{< tweet 877500564405444608 >}} +{{< tweet id="877500564405444608" user="GoHugoIO" >}} ## vimeo {{< vimeo 146022717 >}} diff --git a/exampleSite/config.toml b/exampleSite/hugo.toml similarity index 100% rename from exampleSite/config.toml rename to exampleSite/hugo.toml