From 3c0036805d64fdd8290f1c4a31371780ff3ea365 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Thu, 6 Feb 2020 13:02:49 +0100 Subject: Squashed 'docs/' changes from bd0e15bb6..16753a78d 16753a78d remove kaiju from comments.md 25906f6ad Hugo 0.64.0 aacc7a130 releaser: Add release notes to /docs for release of 0.64.0 2243afe90 Explain Ace/Amber support has been removed 293c9496a Document the hugo function 479890f9b Update comments.md ceab41097 Update theme 9a95876c7 Remove note 696543e13 Update usage.md a04bab2b9 Release 0.63.2 ccaed74b5 Merge branch 'temp632' 623b363c5 releaser: Add release notes to /docs for release of 0.63.2 39ce6f50e releaser: Add release notes to /docs for release of 0.63.2 9175ac2ca Another theme fix 88c264251 Rebuild _vendor e739dc3a8 Release 0.63.1 129ecac84 Merge branch 'temp631' bcd7c1154 releaser: Add release notes to /docs for release of 0.63.1 e4f0d9285 releaser: Add release notes to /docs for release of 0.63.1 6a40124d6 Update theme c486747de Params cleanup c408c4334 netlify: Bump to 0.63.0 7e8a48be8 Adjust base template docs a5920e9aa Adjust release notes d4d25c524 Merge branch 'temp63' 16d981721 releaser: Add release notes to /docs for release of 0.63.0 08ab681d1 releaser: Add release notes to /docs for release of 0.63.0 90feaac39 docs, output: Add base template lookup variant to docs.json afe2b4399 docs, output: Add base template lookup variant to docs.json 1f7466a76 docs: Regen docs helper 7ceefb94a docs: Regen docs helper ee14087cd Remove typo from RenderString.md 6daf333d3 Remove the calibreapp action 682f710d7 docs: Updating 'submodule add' command in "Host on GitHub" to use https instead of ssh. ef57b2dae Improve documentation on slug behavior 835ddd9c2 Fix broken link 137a32f90 Fixed typo in content-management/page-resources 936633e25 Fixed spelling error, "wich" -> "which" a559d41e3 Using a Different Version of Hugo in AWS Amplify 2ee83402d Update rss.md f900a2ce0 Add render-image code example and edit wording bd0a0207c Change wording on Page Resources documentation d213b4599 linuxbrew was renamed to homebrew (#1004) dcb0925f8 Update index.md 789416a08 Release 0.62.2 2dc66f13c releaser: Add release notes to /docs for release of 0.62.2 813fbc865 releaser: Add release notes to /docs for release of 0.62.2 ed5b07df3 docs: Document the new autoHeadingIDType setting 02d4747e5 docs: Document the new autoHeadingIDType setting 406a8a9a6 docs: Regenerate docshelper 065319786 docs: Regenerate docshelper 61d540021 Merge commit '26f1458a2df6b55eee3a5de46f5fec23a43a7c7d' 7cac5909b releaser: Add release notes to /docs for release of 0.62.1 6e30e01a2 releaser: Add release notes to /docs for release of 0.62.0 2694dcdd8 Merge commit '8a4005cf2b0ef34265ff8051a6b76226685fc226' 115dd6782 docs: More on hooks f4460fd54 tpl: Do not return any value in errorf 3587d2998 tpl: Add a warnf template func 7c9b02e30 docs: Regen docshelper a7bfdeb24 Fix incorrect MIME type from image/jpg to image/jpeg 1a6089cfe Preserve HTML Text for link render hooks 4544a998c docs: Footnote c42733258 Add render template hooks for links and images 0d8bec78a Merge commit '2e711a28c71e8667258e5ab824f9b9a71c261b0a' 3974c326c markup/tableofcontents: Add config option for ordered list 8c2bd1a62 releaser: Add release notes to /docs for release of 0.61.0 f00b2d507 releaser: Add release notes to /docs for release of 0.60.1 9a5109838 releaser: Add release notes to /docs for release of 0.60.0 d2c222f71 Add Goldmark as the new default markdown handler df96f9efa Update homepage.md f17e67b4b tpl/collections: Allow dict to create nested structures 5f923768a Merge commit 'efc0b1bb6c6564f54d596467dbc6a18cb206954e' 8a861bf16 Support Go time format strings in permalinks bbb8c4fea releaser: Add release notes to /docs for release of 0.59.1 9d9070dda releaser: Add release notes to /docs for release of 0.59.0 98716176b Merge commit '5ac0f751aa47e52625662215f66efa99a6abfc2e' 2057ba4c5 Merge commit '5070ba6c9e6c492deade3c30cfe769b9dbf7151d' c98bcff07 Merge commit 'b9bd35d72e14932fb6588ff62b90cddef0a060fc' as 'docs' git-subtree-dir: docs git-subtree-split: 16753a78d85e05c4a2cea94e263dda2e0047d155 --- .../layouts/_default/documentation-home.html | 4 + .../gohugoioTheme/layouts/_default/terms.html | 1 - .../gohugoio/gohugoioTheme/layouts/news/list.html | 2 - .../layouts/page/documentation-home.html | 4 - _vendor/modules.txt | 2 +- config.toml | 27 ---- config/_default/params.toml | 2 - content/en/content-management/comments.md | 11 -- .../en/content-management/organization/index.md | 2 +- content/en/content-management/page-resources.md | 6 +- content/en/functions/RenderString.md | 2 +- content/en/functions/hugo.md | 49 +++++++ content/en/functions/lang.Merge.md | 4 - content/en/getting-started/configuration-markup.md | 21 ++- content/en/getting-started/configuration.md | 2 +- content/en/getting-started/installing.md | 8 +- content/en/getting-started/usage.md | 17 --- .../hosting-on-aws-amplify.md | 27 ++++ .../en/hosting-and-deployment/hosting-on-github.md | 2 +- content/en/news/0.62.2-relnotes/index.md | 26 ++++ content/en/news/0.63.0-relnotes/featured-063.png | Bin 0 -> 212246 bytes content/en/news/0.63.0-relnotes/index.md | 126 ++++++++++++++++++ content/en/news/0.63.1-relnotes/index.md | 17 +++ content/en/news/0.63.2-relnotes/index.md | 20 +++ .../0.64.0-relnotes/hugo-64-poster-featured.png | Bin 0 -> 69464 bytes content/en/news/0.64.0-relnotes/index.md | 54 ++++++++ content/en/templates/alternatives.md | 61 +-------- content/en/templates/base.md | 34 +---- content/en/templates/rss.md | 34 +---- data/docs.json | 148 ++++++++++++++++++--- go.mod | 2 +- go.sum | 8 ++ netlify.toml | 8 +- ...3d34e039f_90587_300x0_resize_q10_catmullrom.jpg | Bin 1939 -> 0 bytes ...3d34e039f_90587_300x0_resize_q75_catmullrom.jpg | Bin 5109 -> 0 bytes ...e039f_90587_90x120_fill_q75_catmullrom_left.jpg | Bin 1697 -> 0 bytes ...039f_90587_90x120_fill_q75_catmullrom_right.jpg | Bin 1661 -> 0 bytes ...1403d34e039f_90587_90x90_fit_q75_catmullrom.jpg | Bin 1292 -> 0 bytes ...9f_90587_200x200_fill_q75_catmullrom_smart1.jpg | Bin 3570 -> 0 bytes ...3d34e039f_90587_300x0_resize_q10_catmullrom.jpg | Bin 1939 -> 0 bytes ...3d34e039f_90587_300x0_resize_q75_catmullrom.jpg | Bin 5109 -> 0 bytes ...e039f_90587_90x120_fill_q75_catmullrom_left.jpg | Bin 1697 -> 0 bytes ...039f_90587_90x120_fill_q75_catmullrom_right.jpg | Bin 1661 -> 0 bytes ...1403d34e039f_90587_90x90_fit_q75_catmullrom.jpg | Bin 1292 -> 0 bytes ...29_34584_200x200_fill_q75_catmullrom_smart1.jpg | Bin 0 -> 3760 bytes ...a97f76229_34584_300x0_resize_q10_catmullrom.jpg | Bin 0 -> 1940 bytes ...a97f76229_34584_300x0_resize_q75_catmullrom.jpg | Bin 0 -> 5135 bytes ...76229_34584_90x120_fill_q75_catmullrom_left.jpg | Bin 0 -> 1711 bytes ...6229_34584_90x120_fill_q75_catmullrom_right.jpg | Bin 0 -> 1664 bytes ...f98a97f76229_34584_90x90_fit_q75_catmullrom.jpg | Bin 0 -> 1292 bytes ...aa20f204198_63640_300x0_resize_catmullrom_2.png | Bin 30621 -> 0 bytes ...b303cf97415_34394_300x0_resize_catmullrom_2.png | Bin 0 -> 30578 bytes ...98bf6a10ee_186693_640x0_resize_catmullrom_2.png | Bin 100937 -> 0 bytes ...1b31156bf3a_69978_640x0_resize_catmullrom_2.png | Bin 50111 -> 0 bytes ...e20bf5f60d_217215_640x0_resize_catmullrom_2.png | Bin 127766 -> 0 bytes ...babe8d2cc58_69238_640x0_resize_catmullrom_2.png | Bin 51464 -> 0 bytes ...09ee199ae20_67955_640x0_resize_catmullrom_2.png | Bin 47990 -> 0 bytes ...376edd013b6_74852_640x0_resize_catmullrom_2.png | Bin 52600 -> 0 bytes ...bf077395057_78299_640x0_resize_catmullrom_2.png | Bin 57591 -> 0 bytes ...f2cf549c9d_212246_480x0_resize_catmullrom_2.png | Bin 0 -> 77588 bytes ...f2cf549c9d_212246_640x0_resize_catmullrom_2.png | Bin 0 -> 130344 bytes ...da64ca77fbc_69464_480x0_resize_catmullrom_2.png | Bin 0 -> 28173 bytes ...da64ca77fbc_69464_640x0_resize_catmullrom_2.png | Bin 0 -> 46995 bytes ...5d006d8f64_179291_640x0_resize_catmullrom_2.png | Bin 88936 -> 0 bytes ...c86_387442_600x300_fill_catmullrom_smart1_2.png | Bin 104931 -> 0 bytes ...679_358844_600x300_fill_catmullrom_smart1_2.png | Bin 0 -> 107396 bytes ...18dd7ac099_165718_640x0_resize_catmullrom_2.png | Bin 52357 -> 0 bytes ...750a0f5391_309284_640x0_resize_catmullrom_2.png | Bin 80505 -> 0 bytes ...c62e2912a7_227009_640x0_resize_catmullrom_2.png | Bin 64714 -> 0 bytes ...aa25b0243f_446603_640x0_resize_catmullrom_2.png | Bin 119036 -> 0 bytes ...cdd6ae4737_147459_640x0_resize_catmullrom_2.png | Bin 50540 -> 0 bytes ...4096c4_90149_1024x512_fill_catmullrom_top_2.png | Bin 0 -> 58017 bytes ...96c4_90149_9899cd7de24187b01ab3dc47e102b4bc.png | Bin 0 -> 21829 bytes ...b54c0_126664_1024x512_fill_catmullrom_top_2.png | Bin 57772 -> 0 bytes ...f09fdb54c0_126664_640x0_resize_catmullrom_2.png | Bin 29073 -> 0 bytes ...4c0_126664_97b33e8221e700cd517d4ce317c69e48.png | Bin 21333 -> 0 bytes ...2978f_194841_1024x512_fill_catmullrom_top_2.png | Bin 0 -> 114843 bytes ...78f_194841_23c92e0762c3e5f3f1c3692cbd6884b1.png | Bin 0 -> 40035 bytes ...1b68c2978f_194841_640x0_resize_catmullrom_2.png | Bin 0 -> 55236 bytes ...dc7c9_234973_1024x512_fill_catmullrom_top_2.png | Bin 116441 -> 0 bytes ...07849dc7c9_234973_640x0_resize_catmullrom_2.png | Bin 55485 -> 0 bytes ...7c9_234973_fea71f0b8a2baebaf03af6e3be6229bb.png | Bin 40217 -> 0 bytes ...519a6_769739_1024x512_fill_catmullrom_top_2.png | Bin 0 -> 121137 bytes ...9a6_769739_5cb129a25fe20b8aece4ac55f51a1035.png | Bin 0 -> 43976 bytes ...24b6f519a6_769739_640x0_resize_catmullrom_2.png | Bin 0 -> 59483 bytes ...8f063_809599_1024x512_fill_catmullrom_top_2.png | Bin 119985 -> 0 bytes ...063_809599_5d0cd50b49fef5d99b816cd049191f5e.png | Bin 43147 -> 0 bytes ...3c98b8f063_809599_640x0_resize_catmullrom_2.png | Bin 59087 -> 0 bytes ...76b0c86c95_631206_640x0_resize_catmullrom_2.png | Bin 129787 -> 0 bytes ...9a25912f5c_153794_640x0_resize_catmullrom_2.png | Bin 47639 -> 0 bytes ...c9f75_143336_1024x512_fill_catmullrom_top_2.png | Bin 0 -> 117450 bytes ...f75_143336_7149ee3c86c905bd6c3bab1e343edd89.png | Bin 0 -> 41884 bytes ...8dc5a_232791_1024x512_fill_catmullrom_top_2.png | Bin 119968 -> 0 bytes ...ac9518dc5a_232791_640x0_resize_catmullrom_2.png | Bin 61107 -> 0 bytes ...c5a_232791_6dfd850dc877e20e2554751f779e5953.png | Bin 41947 -> 0 bytes 95 files changed, 507 insertions(+), 224 deletions(-) create mode 100644 _vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/documentation-home.html delete mode 100644 _vendor/github.com/gohugoio/gohugoioTheme/layouts/page/documentation-home.html create mode 100644 content/en/functions/hugo.md create mode 100644 content/en/news/0.62.2-relnotes/index.md create mode 100644 content/en/news/0.63.0-relnotes/featured-063.png create mode 100644 content/en/news/0.63.0-relnotes/index.md create mode 100644 content/en/news/0.63.1-relnotes/index.md create mode 100644 content/en/news/0.63.2-relnotes/index.md create mode 100644 content/en/news/0.64.0-relnotes/hugo-64-poster-featured.png create mode 100644 content/en/news/0.64.0-relnotes/index.md delete mode 100644 resources/_gen/images/about/new-in-032/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_300x0_resize_q10_catmullrom.jpg delete mode 100644 resources/_gen/images/about/new-in-032/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_300x0_resize_q75_catmullrom.jpg delete mode 100644 resources/_gen/images/about/new-in-032/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_90x120_fill_q75_catmullrom_left.jpg delete mode 100644 resources/_gen/images/about/new-in-032/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_90x120_fill_q75_catmullrom_right.jpg delete mode 100644 resources/_gen/images/about/new-in-032/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_90x90_fit_q75_catmullrom.jpg delete mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_200x200_fill_q75_catmullrom_smart1.jpg delete mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_300x0_resize_q10_catmullrom.jpg delete mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_300x0_resize_q75_catmullrom.jpg delete mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_90x120_fill_q75_catmullrom_left.jpg delete mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_90x120_fill_q75_catmullrom_right.jpg delete mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu59e56ffff1bc1d8d122b1403d34e039f_90587_90x90_fit_q75_catmullrom.jpg create mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu875bbbed66c1db46c12ef98a97f76229_34584_200x200_fill_q75_catmullrom_smart1.jpg create mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu875bbbed66c1db46c12ef98a97f76229_34584_300x0_resize_q10_catmullrom.jpg create mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu875bbbed66c1db46c12ef98a97f76229_34584_300x0_resize_q75_catmullrom.jpg create mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu875bbbed66c1db46c12ef98a97f76229_34584_90x120_fill_q75_catmullrom_left.jpg create mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu875bbbed66c1db46c12ef98a97f76229_34584_90x120_fill_q75_catmullrom_right.jpg create mode 100644 resources/_gen/images/content-management/image-processing/sunset_hu875bbbed66c1db46c12ef98a97f76229_34584_90x90_fit_q75_catmullrom.jpg delete mode 100644 resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/content-management/organization/1-featured-content-bundles_hu911524202ff4753624ea0b303cf97415_34394_300x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.38-relnotes/featured-poster_hudf8012d38ef42d46a6cab1b31156bf3a_69978_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.39-relnotes/featured-hugo-39-poster_hu3261e6e65defb4edf9f0fce20bf5f60d_217215_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.40-relnotes/featured-hugo-40-poster_hu20c69e2a166f65e329d8fbabe8d2cc58_69238_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.41-relnotes/featured-hugo-41-poster_hud81cd208cb270af61610509ee199ae20_67955_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.42-relnotes/featured-hugo-42-poster_hue0604c0846526b6d2f8ba376edd013b6_74852_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.63.0-relnotes/featured-063_hu5954e4b26e8962f5849de8f2cf549c9d_212246_480x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.63.0-relnotes/featured-063_hu5954e4b26e8962f5849de8f2cf549c9d_212246_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.64.0-relnotes/hugo-64-poster-featured_hub9938cc6c413edc5157bada64ca77fbc_69464_480x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.64.0-relnotes/hugo-64-poster-featured_hub9938cc6c413edc5157bada64ca77fbc_69464_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/featured_hu30cb938a182ebd06b50ed15d006d8f64_179291_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/sunset-get_hu69849a7cdb847c2393a7b3a7f6061c86_387442_600x300_fill_catmullrom_smart1_2.png create mode 100644 resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/sunset-get_hud0ada96a3532fb27dcd0de96bcce0679_358844_600x300_fill_catmullrom_smart1_2.png delete mode 100644 resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/forestry/featured_hu77de7d99834fa13b854b7fc62e2912a7_227009_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/letsencrypt/featured_hu51cfa254cfc1fb105704d2cdd6ae4737_147459_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/showcase/linode/featured_hu61409040ff547ff1513ae0ebae4096c4_90149_1024x512_fill_catmullrom_top_2.png create mode 100644 resources/_gen/images/showcase/linode/featured_hu61409040ff547ff1513ae0ebae4096c4_90149_9899cd7de24187b01ab3dc47e102b4bc.png delete mode 100644 resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top_2.png delete mode 100644 resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_97b33e8221e700cd517d4ce317c69e48.png create mode 100644 resources/_gen/images/showcase/over/featured-over_hu096cafb8a4c371f6c5d5431b68c2978f_194841_1024x512_fill_catmullrom_top_2.png create mode 100644 resources/_gen/images/showcase/over/featured-over_hu096cafb8a4c371f6c5d5431b68c2978f_194841_23c92e0762c3e5f3f1c3692cbd6884b1.png create mode 100644 resources/_gen/images/showcase/over/featured-over_hu096cafb8a4c371f6c5d5431b68c2978f_194841_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/over/featured-over_hu778fbd1f621ca5db45e30107849dc7c9_234973_1024x512_fill_catmullrom_top_2.png delete mode 100644 resources/_gen/images/showcase/over/featured-over_hu778fbd1f621ca5db45e30107849dc7c9_234973_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/over/featured-over_hu778fbd1f621ca5db45e30107849dc7c9_234973_fea71f0b8a2baebaf03af6e3be6229bb.png create mode 100644 resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu0bb31f1d675c2396ecc2e224b6f519a6_769739_1024x512_fill_catmullrom_top_2.png create mode 100644 resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu0bb31f1d675c2396ecc2e224b6f519a6_769739_5cb129a25fe20b8aece4ac55f51a1035.png create mode 100644 resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu0bb31f1d675c2396ecc2e224b6f519a6_769739_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu8b2836502d9d0176aaacb83c98b8f063_809599_1024x512_fill_catmullrom_top_2.png delete mode 100644 resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu8b2836502d9d0176aaacb83c98b8f063_809599_5d0cd50b49fef5d99b816cd049191f5e.png delete mode 100644 resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu8b2836502d9d0176aaacb83c98b8f063_809599_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/showcase/tomango/featured_hu7e8dbbadbe427cdae3bd5ec313fc9f75_143336_1024x512_fill_catmullrom_top_2.png create mode 100644 resources/_gen/images/showcase/tomango/featured_hu7e8dbbadbe427cdae3bd5ec313fc9f75_143336_7149ee3c86c905bd6c3bab1e343edd89.png delete mode 100644 resources/_gen/images/showcase/tomango/featured_hube95635899674dbe563e9fac9518dc5a_232791_1024x512_fill_catmullrom_top_2.png delete mode 100644 resources/_gen/images/showcase/tomango/featured_hube95635899674dbe563e9fac9518dc5a_232791_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/showcase/tomango/featured_hube95635899674dbe563e9fac9518dc5a_232791_6dfd850dc877e20e2554751f779e5953.png diff --git a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/documentation-home.html b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/documentation-home.html new file mode 100644 index 000000000..91f744c30 --- /dev/null +++ b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/documentation-home.html @@ -0,0 +1,4 @@ +{{ define "main" }} +{{ $section_to_display := (.Site.Taxonomies.categories.fundamentals).Pages | lang.Merge (.Sites.First.Taxonomies.categories.fundamentals).Pages }} + {{ partial "pagelayout.html" (dict "context" . "section_to_display" $section_to_display ) }} +{{ end }} diff --git a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/terms.html b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/terms.html index f6b566656..499eec598 100644 --- a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/terms.html +++ b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/terms.html @@ -1,4 +1,3 @@ -{{/* {{ define "header" }}{{ partial "page-header" . }}{{ end }} */}} {{ define "main" }} {{ $section_to_display := .Pages }}
diff --git a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/news/list.html b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/news/list.html index 5a5284658..eeb8cb2d9 100644 --- a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/news/list.html +++ b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/news/list.html @@ -1,5 +1,3 @@ -{{/* TODO: think about adding these tags back in, but they need to be limited to news -{{ define "header" }}{{ partial "page-header" . }}{{ end }} */}} {{ define "main" }}
diff --git a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/page/documentation-home.html b/_vendor/github.com/gohugoio/gohugoioTheme/layouts/page/documentation-home.html deleted file mode 100644 index 91f744c30..000000000 --- a/_vendor/github.com/gohugoio/gohugoioTheme/layouts/page/documentation-home.html +++ /dev/null @@ -1,4 +0,0 @@ -{{ define "main" }} -{{ $section_to_display := (.Site.Taxonomies.categories.fundamentals).Pages | lang.Merge (.Sites.First.Taxonomies.categories.fundamentals).Pages }} - {{ partial "pagelayout.html" (dict "context" . "section_to_display" $section_to_display ) }} -{{ end }} diff --git a/_vendor/modules.txt b/_vendor/modules.txt index 866b148c5..9c910ea16 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -1 +1 @@ -# github.com/gohugoio/gohugoioTheme v0.0.0-20191021162625-2e7250ca437d +# github.com/gohugoio/gohugoioTheme v0.0.0-20200128164921-1d0bc5482051 diff --git a/config.toml b/config.toml index 2170b20c4..5f46294bf 100644 --- a/config.toml +++ b/config.toml @@ -58,33 +58,6 @@ pattern = "2006" [social] twitter = "GoHugoIO" -#CUSTOM PARAMS -[params] - description = "The world’s fastest framework for building websites" - ## Used for views in rendered HTML (i.e., rather than using the .Hugo variable) - release = "0.55.0-DEV" - ## Setting this to true will add a "noindex" to *EVERY* page on the site - removefromexternalsearch = false - ## Gh repo for site footer (include trailing slash) - ghrepo = "https://github.com/gohugoio/hugoDocs/" - ## GH Repo for filing a new issue - github_repo = "https://github.com/gohugoio/hugo/issues/new" - ### Edit content repo (set to automatically enter "edit" mode; this is good for "improve this page" links) - ghdocsrepo = "https://github.com/gohugoio/hugoDocs/tree/master/docs" - ## Gitter URL - gitter = "https://gitter.im/spf13/hugo" - ## Discuss Forum URL - forum = "https://discourse.gohugo.io/" - ## Google Tag Manager - gtmid = "" - - # First one is picked as the Twitter card image if not set on page. - images = ["images/gohugoio-card.png"] - - flex_box_interior_classes = "flex-auto w-100 w-40-l mr3 mb3 bg-white ba b--moon-gray nested-copy-line-height" - - #sidebar_direction = "sidebar_left" - # MARKDOWN ## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday [blackfriday] diff --git a/config/_default/params.toml b/config/_default/params.toml index 6ddf97e56..f123287b2 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -1,7 +1,5 @@ description = "The world’s fastest framework for building websites" -## Used for views in rendered HTML (i.e., rather than using the .Hugo variable) -release = "0.52" ## Setting this to true will add a "noindex" to *EVERY* page on the site.. removefromexternalsearch = false ## Gh repo for site footer (include trailing slash) diff --git a/content/en/content-management/comments.md b/content/en/content-management/comments.md index 47b3ccf16..26fffaaa6 100644 --- a/content/en/content-management/comments.md +++ b/content/en/content-management/comments.md @@ -53,7 +53,6 @@ There are a few alternatives to commenting on static sites for those who do not * [Static Man](https://staticman.net/) * [Talkyard](https://www.talkyard.io/blog-comments) (Open source, & serverless hosting) -* [txtpen](https://txtpen.github.io/hn/) * [IntenseDebate](https://intensedebate.com/) * [Graph Comment][] * [Muut](https://muut.com/) @@ -64,16 +63,6 @@ There are a few alternatives to commenting on static sites for those who do not * [Commento](https://commento.io/) (Open Source, available as a service, local install, or docker image) * [JustComments](https://just-comments.com) (Open Source, available as a service, can be self-hosted) - - - - [configuration]: /getting-started/configuration/ [disquspartial]: /templates/partials/#disqus diff --git a/content/en/content-management/organization/index.md b/content/en/content-management/organization/index.md index 9ed2dbff3..64d32781a 100644 --- a/content/en/content-management/organization/index.md +++ b/content/en/content-management/organization/index.md @@ -173,7 +173,7 @@ When defined in the front matter, the `slug` can take the place of the filename {{< code file="content/posts/old-post.md" >}} --- -title: New Post +title: A new post with the filename old-post.md slug: "new-post" --- {{< /code >}} diff --git a/content/en/content-management/page-resources.md b/content/en/content-management/page-resources.md index 1a0ef1b2f..d064d6bdc 100644 --- a/content/en/content-management/page-resources.md +++ b/content/en/content-management/page-resources.md @@ -67,7 +67,7 @@ GetMatch ```go // Using Match/GetMatch to find this images/sunset.jpg ? .Resources.Match "images/sun*" ✅ -.Resources.Match "**/Sunset.jpg" ✅ +.Resources.Match "**/sunset.jpg" ✅ .Resources.Match "images/*.jpg" ✅ .Resources.Match "**.jpg" ✅ .Resources.Match "*" 🚫 @@ -78,7 +78,7 @@ GetMatch ## Page Resources Metadata -Page Resources' metadata is managed from their page's front matter with an array/table parameter named `resources`. You can batch assign values using a [wildcards](http://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). +The page resources' metadata is managed from the corresponding page's front matter with an array/table parameter named `resources`. You can batch assign values using [wildcards](http://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). {{% note %}} Resources of type `page` get `Title` etc. from their own front matter. @@ -135,7 +135,7 @@ From the example above: - Every docx in the bundle will receive the `word` icon. {{% warning %}} -The __order matters__ --- Only the **first set** values of the `title`, `name` and `params`-**keys** will be used. Consecutive parameters will be set only for the ones not already set. For example, in the above example, `.Params.icon` is already first set to `"photo"` in `src = "documents/photo_specs.pdf"`. So that would not get overridden to `"pdf"` by the later set `src = "**.pdf"` rule. +The __order matters__ --- Only the **first set** values of the `title`, `name` and `params`-**keys** will be used. Consecutive parameters will be set only for the ones not already set. In the above example, `.Params.icon` is first set to `"photo"` in `src = "documents/photo_specs.pdf"`. So that would not get overridden to `"pdf"` by the later set `src = "**.pdf"` rule. {{%/ warning %}} ### The `:counter` placeholder in `name` and `title` diff --git a/content/en/functions/RenderString.md b/content/en/functions/RenderString.md index e62f0cae0..19ef11e59 100644 --- a/content/en/functions/RenderString.md +++ b/content/en/functions/RenderString.md @@ -32,7 +32,7 @@ Some examples: {{ $optOrg := dict "markup" "org" }} {{ "**Bold Markdown**" | $p.RenderString }} {{ "**Bold Block Markdown**" | $p.RenderString $optBlock }} -{{ "/italic org mode/" | $p.RenderString $optOrg }}:REND +{{ "/italic org mode/" | $p.RenderString $optOrg }} ``` diff --git a/content/en/functions/hugo.md b/content/en/functions/hugo.md new file mode 100644 index 000000000..d615fa721 --- /dev/null +++ b/content/en/functions/hugo.md @@ -0,0 +1,49 @@ +--- +title: hugo +linktitle: hugo +description: The `hugo` function provides easy access to Hugo-related data. +godocref: +date: 2019-01-31 +publishdate: 2019-01-31 +lastmod: 2019-01-31 +keywords: [] +categories: [functions] +menu: + docs: + parent: "functions" +toc: +signature: ["hugo"] +workson: [] +hugoversion: +relatedfuncs: [] +deprecated: false +draft: false +aliases: [] +--- + +`hugo` returns an instance that contains the following functions: + +hugo.Generator +: `` tag for the version of Hugo that generated the site. `hugo.Generator` outputs a *complete* HTML tag; e.g. `` + +hugo.Version +: the current version of the Hugo binary you are using e.g. `0.63.2` + + +`hugo` returns an instance that contains the following functions: + +hugo.Environment +: the current running environment as defined through the `--environment` cli tag. + +hugo.CommitHash +: the git commit hash of the current Hugo binary e.g. `0e8bed9ccffba0df554728b46c5bbf6d78ae5247` + +hugo.BuildDate +: the compile date of the current Hugo binary formatted with RFC 3339 e.g. `2002-10-02T10:00:00-05:00` + + + +{{% note "Use the Hugo Generator Tag" %}} +We highly recommend using `hugo.Generator` in your website's ``. `hugo.Generator` is included by default in all themes hosted on [themes.gohugo.io](https://themes.gohugo.io). The generator tag allows the Hugo team to track the usage and popularity of Hugo. +{{% /note %}} + diff --git a/content/en/functions/lang.Merge.md b/content/en/functions/lang.Merge.md index ecdab3c42..d2fadea12 100644 --- a/content/en/functions/lang.Merge.md +++ b/content/en/functions/lang.Merge.md @@ -37,7 +37,3 @@ A more practical example is to fill in the missing translations from the other l {{ $pages = $pages | lang.Merge .Site.RegularPages }} {{ end }} ``` - -{{% note %}} -Note that the slightly ugly `.Scratch` construct will not be needed once this is fixed: https://github.com/golang/go/issues/10608 -{{% /note %}} diff --git a/content/en/getting-started/configuration-markup.md b/content/en/getting-started/configuration-markup.md index 1ac7e44ea..c69bbb6ed 100644 --- a/content/en/getting-started/configuration-markup.md +++ b/content/en/getting-started/configuration-markup.md @@ -38,6 +38,9 @@ unsafe typographer : This extension substitutes punctuations with typographic entities like [smartypants](https://daringfireball.net/projects/smartypants/). +autoHeadingIDType ("github") {{< new-in "0.62.2" >}} +: The strategy used for creating auto IDs (anchor names). Available types are `github`, `github-ascii` and `blackfriday`. `github` produces GitHub-compatible IDs, `github-ascii` will drop any non-Ascii characters after accent normalization, and `blackfriday` will make the IDs work as with [Blackfriday](#blackfriday), the default Markdown engine before Hugo 0.60. Note that if Goldmark is your default Markdown engine, this is also the strategy used in the [anchorize](/functions/anchorize/) template func. + ### Blackfriday @@ -122,17 +125,31 @@ Text PlainText : The plain variant of the above. -A Markdown example for an inline-style link with title: +#### Link with title Markdown example : ```md [Text](https://www.gohugo.io "Title") ``` -A very simple template example given the above: +Here is a code example for how the render-link.html template could look: {{< code file="layouts/_default/_markup/render-link.html" >}} {{ .Text }} {{< /code >}} +#### Image Markdown example: + +```md +![Text](https://d33wubrfki0l68.cloudfront.net/c38c7334cc3f23585738e40334284fddcaf03d5e/2e17c/images/hugo-logo-wide.svg "Title") +``` + +Here is a code example for how the render-image.html template could look: + +{{< code file="layouts/_default/_markup/render-image.html" >}} +

+ {{ .Text }} +

+{{< /code >}} + [^hooktemplate]: It's currently only possible to have one set of render hook templates, e.g. not per `Type` or `Section`. We may consider that in a future version. diff --git a/content/en/getting-started/configuration.md b/content/en/getting-started/configuration.md index a53612ff4..b19cb45d9 100644 --- a/content/en/getting-started/configuration.md +++ b/content/en/getting-started/configuration.md @@ -85,7 +85,7 @@ baseURL : Hostname (and path) to the root, e.g. https://bep.is/ blackfriday -: See [Configure Blackfriday](/getting-started/configuration/#configure-blackfriday) +: See [Configure Blackfriday](/getting-started/configuration-markup#blackfriday) buildDrafts (false) : Include drafts when building. diff --git a/content/en/getting-started/installing.md b/content/en/getting-started/installing.md index 931849e77..ad70c18a1 100644 --- a/content/en/getting-started/installing.md +++ b/content/en/getting-started/installing.md @@ -54,15 +54,15 @@ brew install hugo For more detailed explanations, read the installation guides that follow for installing on macOS and Windows. -### Linuxbrew (Linux) +### Homebrew (Linux) -If you are on Linux and using [Linuxbrew][linuxbrew], you can install Hugo with the following one-liner: +If you are using [Homebrew][linuxbrew] on Linux, you can install Hugo with the following one-liner: {{< code file="install-with-linuxbrew.sh" >}} brew install hugo {{< /code >}} -Installation guides for Linuxbrew are available on their [website][linuxbrew]. +Installation guides for Homebrew on Linux are available on their [website][linuxbrew]. ### Chocolatey (Windows) @@ -518,7 +518,7 @@ Now that you've installed Hugo, read the [Quick Start guide][quickstart] and exp [highlight shortcode]: /content-management/shortcodes/#highlight [installgit]: https://git-scm.com/ [installgo]: https://golang.org/dl/ -[linuxbrew]: https://linuxbrew.sh/ +[linuxbrew]: https://docs.brew.sh/Homebrew-on-Linux [Path Editor]: https://patheditor2.codeplex.com/ [pygments]: http://pygments.org [quickstart]: /getting-started/quick-start/ diff --git a/content/en/getting-started/usage.md b/content/en/getting-started/usage.md index c5dcc9cca..e35126fd0 100644 --- a/content/en/getting-started/usage.md +++ b/content/en/getting-started/usage.md @@ -203,23 +203,6 @@ Since Hugo generates a static website, your site can be hosted *anywhere* using Running `hugo` *does not* remove generated files before building. This means that you should delete your `public/` directory (or the publish directory you specified via flag or configuration file) before running the `hugo` command. If you do not remove these files, you run the risk of the wrong files (e.g., drafts or future posts) being left in the generated site. {{% /warning %}} -### Dev vs Deploy Destinations - -Hugo does not remove generated files before building. An easy workaround is to use different directories for development and production. - -To start a server that builds draft content (helpful for editing), you can specify a different destination; e.g., a `dev/` directory: - -``` -hugo server -wDs ~/Code/hugo/docs -d dev -``` - -When the content is ready for publishing, use the default `public/` dir: - -``` -hugo -s ~/Code/hugo/docs -``` - -This prevents draft content from accidentally becoming available. [commands]: /commands/ [config]: /getting-started/configuration/ diff --git a/content/en/hosting-and-deployment/hosting-on-aws-amplify.md b/content/en/hosting-and-deployment/hosting-on-aws-amplify.md index d310cf732..9bcfdcbf2 100644 --- a/content/en/hosting-and-deployment/hosting-on-aws-amplify.md +++ b/content/en/hosting-and-deployment/hosting-on-aws-amplify.md @@ -42,4 +42,31 @@ AWS Amplify is a combination of client library, CLI toolchain, and a Console for 1. Review your changes and then choose **Save and deploy**. The Amplify Console will pull code from your repository, build changes to the backend and frontend, and deploy your build artifacts at `https://master.unique-id.amplifyapp.com`. Bonus: Screenshots of your app on different devices to find layout issues. +## Using a Newer Version of Hugo + +If you need to use a different, perhaps newer, version of Hugo than the version currently supported by AWS Amplify, you can modify your build commands to include the downloading of Hugo itself. Here's an example of a build definition that includes the downloading of Hugo. Note that in ths example the "extended" version of Hugo is being used which includes support for SASS/SCSS. + +``` +version: 0.1 +frontend: + phases: + # IMPORTANT - Please verify your build commands + build: + commands: + - wget https://github.com/gohugoio/hugo/releases/download/v0.62.2/hugo_extended_0.62.2_Linux-64bit.tar.gz + - tar -xf hugo_extended_0.62.2_Linux-64bit.tar.gz + - mv hugo /usr/bin/hugo + - rm -rf hugo_extended_0.62.2_Linux-64bit.tar.gz + - hugo version + - hugo + artifacts: + # IMPORTANT - Please verify your build output directory + baseDirectory: public + files: + - '**/*' + cache: + paths: [] + +``` + [Quick Start]: /getting-started/quick-start/ diff --git a/content/en/hosting-and-deployment/hosting-on-github.md b/content/en/hosting-and-deployment/hosting-on-github.md index 200c216c8..9307a2758 100644 --- a/content/en/hosting-and-deployment/hosting-on-github.md +++ b/content/en/hosting-and-deployment/hosting-on-github.md @@ -58,7 +58,7 @@ This is a much simpler setup as your Hugo files and generated content are publis 5. Once you are happy with the results: * Press Ctrl+C to kill the server * Before proceeding run `rm -rf public` to completely remove the `public` directory -6. `git submodule add -b master git@github.com:/.github.io.git public`. This creates a git [submodule][]. Now when you run the `hugo` command to build your site to `public`, the created `public` directory will have a different remote origin (i.e. hosted GitHub repository). +6. `git submodule add -b master https://github.com//.github.io.git public`. This creates a git [submodule][]. Now when you run the `hugo` command to build your site to `public`, the created `public` directory will have a different remote origin (i.e. hosted GitHub repository). ### Put it Into a Script diff --git a/content/en/news/0.62.2-relnotes/index.md b/content/en/news/0.62.2-relnotes/index.md new file mode 100644 index 000000000..0d116e5a2 --- /dev/null +++ b/content/en/news/0.62.2-relnotes/index.md @@ -0,0 +1,26 @@ + +--- +date: 2020-01-05 +title: "Hugo 0.62.2: A couple of Bug Fixes" +description: "This version fixes a couple of bugs introduced in 0.62.0." +categories: ["Releases"] +images: +- images/blog/hugo-bug-poster.png + +--- + +The main driving force behind these patch releases in the new year has been getting a good story with [portable links](https://github.com/bep/portable-hugo-links/) between GitHub and Hugo, using the new render hooks introduced in [Hugo 0.62.0](https://gohugo.io/news/0.62.0-relnotes/). And all was mostly well until a Hugo user asked about anchor links. Which is, when you look into it, a slightly sad Markdown story. They have been [talking about anchors in Markdown](https://talk.commonmark.org/t/anchors-in-markdown/247) over at the CommonMark forum for the last six years, but it has come to nothing. The current situation is that some Markdown engines support the `{#anchorName}` attribute syntax (Hugo's Goldmark does, GitHub does not) and for those that support auto-generation of IDs, the implementation often varies. And this makes for poor portability. + +To improve this, Hugo has now reverse-engineered GitHub's implementation and made that the default strategy for generation or header IDs. We understand that this isn't everyone's cup of tea, so you can [configure the behaviour](https://gohugo.io/getting-started/configuration-markup#goldmark) to be one of `github`, `github-ascii` (some client-libraries have Unicode issues) or `blackfriday` (which will match how it behaved before Hugo 0.60). + +* hugolib: Fix relative .Page.GetPage from bundle [196a9df5](https://github.com/gohugoio/hugo/commit/196a9df585c4744e3280f37c1c24e469fce14b8c) [@bep](https://github.com/bep) [#6705](https://github.com/gohugoio/hugo/issues/6705) +* markup/goldmark: Adjust auto ID space handling [9b6e6146](https://github.com/gohugoio/hugo/commit/9b6e61464b09ffe3423fb8d7c72bddb7a9ed5b98) [@bep](https://github.com/bep) [#6710](https://github.com/gohugoio/hugo/issues/6710) +* docs: Document the new autoHeadingIDType setting [d62ede8e](https://github.com/gohugoio/hugo/commit/d62ede8e9e5883e7ebb023e49b82f07b45edc1c7) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707)[#6616](https://github.com/gohugoio/hugo/issues/6616) +* docs: Regenerate docshelper [81b7e48a](https://github.com/gohugoio/hugo/commit/81b7e48a55092203aeee8785799e6fed3928760e) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707)[#6616](https://github.com/gohugoio/hugo/issues/6616) +* markup/goldmark: Add an optional Blackfriday auto ID strategy [16e7c112](https://github.com/gohugoio/hugo/commit/16e7c1120346bd853cf6510ffac8e94824bf2c7f) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707) +* markup/goldmark: Make the autoID type config a string [8f071fc1](https://github.com/gohugoio/hugo/commit/8f071fc159ce9a0fc0ea14a73bde8f299bedd109) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707) +* markup/goldmark: Simplify code [5ee1f087](https://github.com/gohugoio/hugo/commit/5ee1f0876f3ec8b79d6305298185dc821ead2d28) [@bep](https://github.com/bep) +* markup/goldmark: Make auto IDs GitHub compatible [a82d2700](https://github.com/gohugoio/hugo/commit/a82d2700fcc772aada15d65b8f76913ca23f7404) [@bep](https://github.com/bep) [#6616](https://github.com/gohugoio/hugo/issues/6616) + + + diff --git a/content/en/news/0.63.0-relnotes/featured-063.png b/content/en/news/0.63.0-relnotes/featured-063.png new file mode 100644 index 000000000..3944d52cc Binary files /dev/null and b/content/en/news/0.63.0-relnotes/featured-063.png differ diff --git a/content/en/news/0.63.0-relnotes/index.md b/content/en/news/0.63.0-relnotes/index.md new file mode 100644 index 000000000..899dfdb39 --- /dev/null +++ b/content/en/news/0.63.0-relnotes/index.md @@ -0,0 +1,126 @@ + +--- +date: 2020-01-23 +title: "Improved base templates, and faster!" +description: "In Hugo 0.63 we have improved the base template lookup logic, and this simplification also made Hugo faster …" +categories: ["Releases"] +--- + +**Note:** There is already a [patch release](/news/0.63.1-relnotes/) with some fixes. + +Hugo `0.63` is, in general, **considerably faster and more memory effective** (see the site-building benchmarks below comparing it to `v0.62`). Not that we are particularly concerned about Hugo's build speed. We leave that to others. But we would hate if it got slower, so we have a comprehensive benchmark suite. And when we needed to simplify the template handling code to solve a concurrency issue, it also became more effective. And as a bonus, we also finally got the [base template lookup order](https://gohugo.io/templates/base/#base-template-lookup-order) that you really, really wanted! + +```bash +name old time/op new time/op delta +SiteNew/Bundle_with_image-16 13.2ms ± 2% 10.7ms ± 0% -19.13% (p=0.029 n=4+4) +SiteNew/Bundle_with_JSON_file-16 13.1ms ± 0% 10.8ms ± 0% -17.50% (p=0.029 n=4+4) +SiteNew/Tags_and_categories-16 47.7ms ± 1% 43.7ms ± 2% -8.43% (p=0.029 n=4+4) +SiteNew/Canonify_URLs-16 52.3ms ± 6% 49.5ms ± 7% ~ (p=0.200 n=4+4) +SiteNew/Deep_content_tree-16 77.7ms ± 0% 71.6ms ± 1% -7.84% (p=0.029 n=4+4) +SiteNew/Many_HTML_templates-16 44.0ms ± 2% 37.5ms ± 1% -14.79% (p=0.029 n=4+4) +SiteNew/Page_collections-16 58.4ms ± 1% 52.5ms ± 1% -10.09% (p=0.029 n=4+4) + +name old alloc/op new alloc/op delta +SiteNew/Bundle_with_image-16 3.81MB ± 0% 2.22MB ± 0% -41.57% (p=0.029 n=4+4) +SiteNew/Bundle_with_JSON_file-16 3.60MB ± 0% 2.01MB ± 0% -44.09% (p=0.029 n=4+4) +SiteNew/Tags_and_categories-16 19.3MB ± 1% 14.2MB ± 0% -26.52% (p=0.029 n=4+4) +SiteNew/Canonify_URLs-16 70.7MB ± 0% 69.0MB ± 0% -2.30% (p=0.029 n=4+4) +SiteNew/Deep_content_tree-16 37.0MB ± 0% 31.2MB ± 0% -15.78% (p=0.029 n=4+4) +SiteNew/Many_HTML_templates-16 17.5MB ± 0% 10.6MB ± 0% -39.68% (p=0.029 n=4+4) +SiteNew/Page_collections-16 25.8MB ± 0% 21.2MB ± 0% -17.80% (p=0.029 n=4+4) + +name old allocs/op new allocs/op delta +SiteNew/Bundle_with_image-16 52.3k ± 0% 26.1k ± 0% -50.08% (p=0.029 n=4+4) +SiteNew/Bundle_with_JSON_file-16 52.3k ± 0% 26.1k ± 0% -50.06% (p=0.029 n=4+4) +SiteNew/Tags_and_categories-16 337k ± 1% 272k ± 0% -19.20% (p=0.029 n=4+4) +SiteNew/Canonify_URLs-16 422k ± 0% 395k ± 0% -6.33% (p=0.029 n=4+4) +SiteNew/Deep_content_tree-16 400k ± 0% 314k ± 0% -21.41% (p=0.029 n=4+4) +SiteNew/Many_HTML_templates-16 247k ± 0% 143k ± 0% -41.84% (p=0.029 n=4+4) +SiteNew/Page_collections-16 282k ± 0% 207k ± 0% -26.31% (p=0.029 n=4+4) +``` + +This release represents **35 contributions by 9 contributors** to the main Hugo code base. [@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@hcwong](https://github.com/hcwong), [@flother](https://github.com/flother), and [@RemcodM](https://github.com/RemcodM) for their ongoing contributions. + +And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) and [@onedrawingperday](https://github.com/onedrawingperday) for their relentless work on keeping the themes site in pristine condition and to [@davidsneighbour](https://github.com/davidsneighbour) and [@kaushalmodi](https://github.com/kaushalmodi) for all the great work on the documentation site. + +Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs), +which has received **13 contributions by 10 contributors**. A special thanks to [@bep](https://github.com/bep), [@jeffscottlevine](https://github.com/jeffscottlevine), [@davidsneighbour](https://github.com/davidsneighbour), and [@nicfits](https://github.com/nicfits) for their work on the documentation site. + + +Hugo now has: + +* 41091+ [stars](https://github.com/gohugoio/hugo/stargazers) +* 440+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors) +* 286+ [themes](http://themes.gohugo.io/) + +## Notes + +* `.Type` on-page now returns an empty string if not set in the front matter or if `.Section` returns empty. See [#6760](https://github.com/gohugoio/hugo/issues/6760). +* Baseof template (e.g. `baseof.html`) lookup order is completely revised/expanded. See [base template lookup order](https://gohugo.io/templates/base/#base-template-lookup-order). We now do template resolution at execution time following the same rules as the template it applies to (e.g. `_default/single.html`). This is an obvious improvement and your site should work as before. +* Shortcode params now supports params with raw string literals (strings surrounded with \`\`) that supports newlines. +* Note: In a base template (e.g. `baseof.html`), the first template block must be a `define`. + +## Enhancements + +### Templates + +* Rework template management to get rid of concurrency issues [c6d650c8](https://github.com/gohugoio/hugo/commit/c6d650c8c8b22fdc7ddedc1e42a3ca698e1390d6) [@bep](https://github.com/bep) [#6716](https://github.com/gohugoio/hugo/issues/6716)[#6760](https://github.com/gohugoio/hugo/issues/6760)[#6768](https://github.com/gohugoio/hugo/issues/6768)[#6778](https://github.com/gohugoio/hugo/issues/6778) +* Put Go's internal template funcs in Hugo's map [1cf23541](https://github.com/gohugoio/hugo/commit/1cf235412f98b42aefe368e99a0e9e95bae6eef7) [@bep](https://github.com/bep) [#6717](https://github.com/gohugoio/hugo/issues/6717) + +### Output + +* Add base template lookup variant to docs.json [cafb1d53](https://github.com/gohugoio/hugo/commit/cafb1d53c0927e2aef8abff1bf9095c90c6f3067) [@bep](https://github.com/bep) + +### Core + +* Disable a test assertion on ARM [836c2426](https://github.com/gohugoio/hugo/commit/836c24261f9f175254256fb326d92a3db47e1c75) [@bep](https://github.com/bep) [#6655](https://github.com/gohugoio/hugo/issues/6655) +* Some more benchmark adjustments [ddd75f21](https://github.com/gohugoio/hugo/commit/ddd75f212110a3d6643a07301e377415f3d163bd) [@bep](https://github.com/bep) +* Adjust site benchmarks [4ed6ebef](https://github.com/gohugoio/hugo/commit/4ed6ebef4ca71572a19bb890cb4c026a688b2b5b) [@bep](https://github.com/bep) +* Add a benchmark with lots of templates [ea05c0e8](https://github.com/gohugoio/hugo/commit/ea05c0e8456e8dec71ffd796148355b0d8b36eb0) [@bep](https://github.com/bep) + +### Other + +* Regen docs helper [4f466db6](https://github.com/gohugoio/hugo/commit/4f466db666dded1b6c6d1e6926e170f22164433a) [@bep](https://github.com/bep) +* Allow multiple arguments in ne/ge/gt/le/lt functions Treat op arg1 arg2 arg3 ... as (arg1 op arg2) && (arg1 op arg3) and so on for ne/ge/gt/le/lt. [0c251be6](https://github.com/gohugoio/hugo/commit/0c251be66bf3ad4abafbc47583e394ca4e6ffcf1) [@le0tan](https://github.com/le0tan) [#6619](https://github.com/gohugoio/hugo/issues/6619) +* Update go-org [8585b388](https://github.com/gohugoio/hugo/commit/8585b388d27abde1ab6b6c63ad6addf4066ec8dd) [@niklasfasching](https://github.com/niklasfasching) +* Add support for newline characters in raw string shortcode [21ca2e9c](https://github.com/gohugoio/hugo/commit/21ca2e9ce4255bfad2bb0576aff087a240acf70a) [@hcwong](https://github.com/hcwong) +* Update github.com/alecthomas/chroma [3efa1d81](https://github.com/gohugoio/hugo/commit/3efa1d81219a6e7b41c9676e9cab446741f69055) [@ghislainbourgeois](https://github.com/ghislainbourgeois) +* Update minify to v2.7.2 [65ec8fe8](https://github.com/gohugoio/hugo/commit/65ec8fe827efef5a14c4e1bc440a6df97d2f20a2) [@bep](https://github.com/bep) [#6756](https://github.com/gohugoio/hugo/issues/6756) +* Update Goldmark to v1.1.21 [d3e8ab2e](https://github.com/gohugoio/hugo/commit/d3e8ab2e39dcc27853b163079f4a82364286fe82) [@flother](https://github.com/flother) [#6571](https://github.com/gohugoio/hugo/issues/6571) +* Allow raw string literals in shortcode params [da814556](https://github.com/gohugoio/hugo/commit/da814556567eab9ba0ac5fef5314c3ad5ee50ccd) [@hcwong](https://github.com/hcwong) +* Update github.com/gohugoio/testmodBuilder [0c0bb372](https://github.com/gohugoio/hugo/commit/0c0bb372858b5de58c15ccd300144e0bc205ffad) [@bep](https://github.com/bep) +* Update direct dependencies [94cfdf6b](https://github.com/gohugoio/hugo/commit/94cfdf6befd657e46c9458b23f17d851cd2f7037) [@bep](https://github.com/bep) [#6719](https://github.com/gohugoio/hugo/issues/6719) +* Update to new CSS config [45138017](https://github.com/gohugoio/hugo/commit/451380177868e48127a33362aa8d553b90516fb5) [@bep](https://github.com/bep) [#6719](https://github.com/gohugoio/hugo/issues/6719) +* Update to Minify v2.7.0 [56354a63](https://github.com/gohugoio/hugo/commit/56354a63bb73271224a9300a4742dc1a2f551202) [@bep](https://github.com/bep) +* Add support for freebsd/arm64 [aead8108](https://github.com/gohugoio/hugo/commit/aead8108b80d77e23c68a47fd8d86464310130be) [@dmgk](https://github.com/dmgk) [#6719](https://github.com/gohugoio/hugo/issues/6719) +* Update releasenotes_writer.go [df6e9efd](https://github.com/gohugoio/hugo/commit/df6e9efd8f345707932231ea23dc8713afb5b026) [@bep](https://github.com/bep) +* Adjust auto ID space handling [9b6e6146](https://github.com/gohugoio/hugo/commit/9b6e61464b09ffe3423fb8d7c72bddb7a9ed5b98) [@bep](https://github.com/bep) [#6710](https://github.com/gohugoio/hugo/issues/6710) +* Document the new autoHeadingIDType setting [d62ede8e](https://github.com/gohugoio/hugo/commit/d62ede8e9e5883e7ebb023e49b82f07b45edc1c7) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707)[#6616](https://github.com/gohugoio/hugo/issues/6616) +* Regenerate docshelper [81b7e48a](https://github.com/gohugoio/hugo/commit/81b7e48a55092203aeee8785799e6fed3928760e) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707)[#6616](https://github.com/gohugoio/hugo/issues/6616) +* Add an optional Blackfriday auto ID strategy [16e7c112](https://github.com/gohugoio/hugo/commit/16e7c1120346bd853cf6510ffac8e94824bf2c7f) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707) +* Make the autoID type config a string [8f071fc1](https://github.com/gohugoio/hugo/commit/8f071fc159ce9a0fc0ea14a73bde8f299bedd109) [@bep](https://github.com/bep) [#6707](https://github.com/gohugoio/hugo/issues/6707) +* markup/goldmark: Simplify code [5ee1f087](https://github.com/gohugoio/hugo/commit/5ee1f0876f3ec8b79d6305298185dc821ead2d28) [@bep](https://github.com/bep) +* Make auto IDs GitHub compatible [a82d2700](https://github.com/gohugoio/hugo/commit/a82d2700fcc772aada15d65b8f76913ca23f7404) [@bep](https://github.com/bep) [#6616](https://github.com/gohugoio/hugo/issues/6616) +* Support files in content mounts [ff6253bc](https://github.com/gohugoio/hugo/commit/ff6253bc7cf745e9c0127ddc9006da3c2c00c738) [@bep](https://github.com/bep) [#6684](https://github.com/gohugoio/hugo/issues/6684)[#6696](https://github.com/gohugoio/hugo/issues/6696) +* Update alpine base image in Dockerfile to 3.11 [aa4ccb8a](https://github.com/gohugoio/hugo/commit/aa4ccb8a1e9b8aa17397acf34049a2aa16b0b6cb) [@RemcodM](https://github.com/RemcodM) + +## Fixes + +### Templates + +* Fix eq when > 2 args [2fefc016](https://github.com/gohugoio/hugo/commit/2fefc01606fddb119f368c89fb2dedd452ad6547) [@bep](https://github.com/bep) [#6786](https://github.com/gohugoio/hugo/issues/6786) + +### Core + +* Fix relative .Page.GetPage from bundle [196a9df5](https://github.com/gohugoio/hugo/commit/196a9df585c4744e3280f37c1c24e469fce14b8c) [@bep](https://github.com/bep) [#6705](https://github.com/gohugoio/hugo/issues/6705) +* Fix inline shortcode regression [5509954c](https://github.com/gohugoio/hugo/commit/5509954c7e8b0ce8d5ea903b0ab639ea14b69acb) [@bep](https://github.com/bep) [#6677](https://github.com/gohugoio/hugo/issues/6677) + +### Other + +* Fix 0.62.1 server rebuild slowdown regression [17af79a0](https://github.com/gohugoio/hugo/commit/17af79a03e249a731cf5634ffea23ca00774333d) [@bep](https://github.com/bep) [#6784](https://github.com/gohugoio/hugo/issues/6784) +* Fix blog not building [d61bee5e](https://github.com/gohugoio/hugo/commit/d61bee5e0916b5d2b388e66ef85c336312a21a06) [@colonelpopcorn](https://github.com/colonelpopcorn) [#6752](https://github.com/gohugoio/hugo/issues/6752) + + + + + diff --git a/content/en/news/0.63.1-relnotes/index.md b/content/en/news/0.63.1-relnotes/index.md new file mode 100644 index 000000000..e6ae8b906 --- /dev/null +++ b/content/en/news/0.63.1-relnotes/index.md @@ -0,0 +1,17 @@ + +--- +date: 2020-01-23 +title: "Hugo 0.63.1: A couple of Bug Fixes" +description: "This version fixes a couple of bugs introduced in 0.63.0." +categories: ["Releases"] +images: +- images/blog/hugo-bug-poster.png + +--- + +This is a bug-fix release with a couple of important fixes. + +* deps: Make the build flags shared between sites [0df7bd62](https://github.com/gohugoio/hugo/commit/0df7bd62df460a49544845d5332f33b2020b48a1) [@bep](https://github.com/bep) [#6789](https://github.com/gohugoio/hugo/issues/6789) +* Fix baseof with regular define regression [f441f675](https://github.com/gohugoio/hugo/commit/f441f675126ef1123d9f94429872dd683b40e011) [@bep](https://github.com/bep) [#6790](https://github.com/gohugoio/hugo/issues/6790) +* Revert to minify [v2.61](https://github.com/gohugoio/hugo/commit/7ed22e9fb6a5b74c52ae6054b843b8c64e83f4b6) + diff --git a/content/en/news/0.63.2-relnotes/index.md b/content/en/news/0.63.2-relnotes/index.md new file mode 100644 index 000000000..8477ef02c --- /dev/null +++ b/content/en/news/0.63.2-relnotes/index.md @@ -0,0 +1,20 @@ + +--- +date: 2020-01-27 +title: "Hugo 0.63.2: A couple of Bug Fixes" +description: "This version fixes a couple of bugs introduced in 0.63.0." +categories: ["Releases"] +images: +- images/blog/hugo-bug-poster.png + +--- + + + +This is a bug-fix release with a couple of important fixes. + +* And now finally fix the 404 templates [74b6c4e5](https://github.com/gohugoio/hugo/commit/74b6c4e5ff5ee16f0e6b352a26c1e58b90a25dc6) [@bep](https://github.com/bep) [#6795](https://github.com/gohugoio/hugo/issues/6795) +* Fix 404 with base template regression [8df5d76e](https://github.com/gohugoio/hugo/commit/8df5d76e708238563185bac84809b34a4d395734) [@bep](https://github.com/bep) [#6795](https://github.com/gohugoio/hugo/issues/6795) +* Revert to .Type = "page" when empty [#6805](https://github.com/gohugoio/hugo/issues/6805) + + diff --git a/content/en/news/0.64.0-relnotes/hugo-64-poster-featured.png b/content/en/news/0.64.0-relnotes/hugo-64-poster-featured.png new file mode 100644 index 000000000..71861bad8 Binary files /dev/null and b/content/en/news/0.64.0-relnotes/hugo-64-poster-featured.png differ diff --git a/content/en/news/0.64.0-relnotes/index.md b/content/en/news/0.64.0-relnotes/index.md new file mode 100644 index 000000000..e03dc8f54 --- /dev/null +++ b/content/en/news/0.64.0-relnotes/index.md @@ -0,0 +1,54 @@ + +--- +date: 2020-02-04 +title: "Mostly bugfixes …" +description: "Hugo 0.64.0 is the version you really really want …" +categories: ["Releases"] +--- + +Hugo **0.64.0** is mostly a bugfix-release, but well worth the download. The main reason this release comes so soon after the previous is my (me being [@bep](https://github.com/bep)) ongoing work on getting solid support for third-party libraries in [Hugo Modules](https://gohugo.io/hugo-modules/). In particular, this release makes the Hugo server's live-reload work with [Turbolinks](https://github.com/bep/hugo-alpine-test/blob/27927832630be588eab0be2197cc8c0cb5725540/config.toml#L11) and similar. Also worth mentioning is that `hugo mod get -u` (without any path) now correctly updates every module imported in `config.toml` even with Go 1.13. + +This release represents **16 contributions by 2 contributors** to the main Hugo code base. +Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs), +which has received **6 contributions by 4 contributors**. A special thanks to [@bep](https://github.com/bep), [@peterkappus](https://github.com/peterkappus), [@kc0bfv](https://github.com/kc0bfv), and [@inwardmovement](https://github.com/inwardmovement) for their work on the documentation site. + + +Hugo now has: + +* 41348+ [stars](https://github.com/gohugoio/hugo/stargazers) +* 439+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors) +* 289+ [themes](http://themes.gohugo.io/) + +## Enhancements + +### Output + +* Do not render alias paginator pages for non-HTML outputs [2d159e9c](https://github.com/gohugoio/hugo/commit/2d159e9cc7a25832e4b0cad226b149f7c4624708) [@bep](https://github.com/bep) [#6797](https://github.com/gohugoio/hugo/issues/6797) + +### Other + +* Mention a "no CGO rule" [29973101](https://github.com/gohugoio/hugo/commit/299731012441378bb9c057ceb0a3c277108aaf01) [@bep](https://github.com/bep) [#6842](https://github.com/gohugoio/hugo/issues/6842) +* Update to Go 1.13.7 and Go 1.12.16 [0792cfa9](https://github.com/gohugoio/hugo/commit/0792cfa9fae94a06a31e393a46fed3b1dd73b66a) [@bep](https://github.com/bep) [#6830](https://github.com/gohugoio/hugo/issues/6830) +* Add defer to livereload script tag [b3f0674b](https://github.com/gohugoio/hugo/commit/b3f0674b80a32425aeb4412f318c720391bbf773) [@bep](https://github.com/bep) +* Don't use document.write to inject livereload [ef78a0d1](https://github.com/gohugoio/hugo/commit/ef78a0d18a13098bcea1ff2b2d45d7388b8d41a0) [@bep](https://github.com/bep) [#6507](https://github.com/gohugoio/hugo/issues/6507) +* Add a render hook whitespace test [58595864](https://github.com/gohugoio/hugo/commit/585958645372e6219239247dbac02e447d2b355b) [@bep](https://github.com/bep) [#6832](https://github.com/gohugoio/hugo/issues/6832) +* Inject livereload script right after head if possible [8f08cdd0](https://github.com/gohugoio/hugo/commit/8f08cdd0ac6a2decd5aa5c9c12c0b2c264f9a989) [@bep](https://github.com/bep) [#6821](https://github.com/gohugoio/hugo/issues/6821) +* Update goldmark to v1.1.22 [281abb18](https://github.com/gohugoio/hugo/commit/281abb18ee39fa2b5d4782b64f27cffcbf4e0240) [@bhavin192](https://github.com/bhavin192) +* Make the build flags shared between sites [0df7bd62](https://github.com/gohugoio/hugo/commit/0df7bd62df460a49544845d5332f33b2020b48a1) [@bep](https://github.com/bep) [#6789](https://github.com/gohugoio/hugo/issues/6789) + +## Fixes + +### Other + +* Fix module mount in sub folder [80dd6ddd](https://github.com/gohugoio/hugo/commit/80dd6ddde27ce36f5432fb780e94d4974b5277c7) [@bep](https://github.com/bep) [#6730](https://github.com/gohugoio/hugo/issues/6730) +* Fix config environment handling [2bbc865f](https://github.com/gohugoio/hugo/commit/2bbc865f7bb713b2d0d2dbb02b90ae2621ad5367) [@bep](https://github.com/bep) [#6503](https://github.com/gohugoio/hugo/issues/6503)[#6824](https://github.com/gohugoio/hugo/issues/6824) +* Fix base template handling with preceding comments [f45cb317](https://github.com/gohugoio/hugo/commit/f45cb3172862140883cfa08bd401c17e1ada5b39) [@bep](https://github.com/bep) [#6816](https://github.com/gohugoio/hugo/issues/6816) +* Fix "hugo mod get -u" with no arguments [49ef6472](https://github.com/gohugoio/hugo/commit/49ef6472039ede7d485242eba511207a8274495a) [@bep](https://github.com/bep) [