mirror of https://github.com/jpanther/congo.git
149 lines
53 KiB
HTML
149 lines
53 KiB
HTML
<!doctype html><html lang=zh-CN dir=ltr class=scroll-smooth data-default-appearance=light data-auto-appearance=true><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=theme-color content="rgb(255,255,255)"><title>内容示例 · Congo</title>
|
||
<meta name=title content="内容示例 · Congo"><script type=text/javascript src=/congo/js/appearance.min.022d0ebc3b46a335eb1c7ef79b7f2de143d7cd5156d433638592ef1ce5f8554e.js integrity="sha256-Ai0OvDtGozXrHH73m38t4UPXzVFW1DNjhZLvHOX4VU4="></script><link type=text/css rel=stylesheet href=/congo/css/main.bundle.min.33a669351b9f936b30a0fc74240c4bd296cb15c8b2b1e40ea9ee7b6658af735b.css integrity="sha256-M6ZpNRufk2swoPx0JAxL0pbLFciyseQOqe57Zlivc1s="><script defer type=text/javascript id=script-bundle src=/congo/js/main.bundle.min.fba363b244ec92c2d7b9de42d4cebd0b8994fd07279923c5929eb4dc3d055606.js integrity="sha256-+6NjskTsksLXud5C1M69C4mU/QcnmSPFkp603D0FVgY=" data-copy=复制 data-copied=已复制></script><meta name=description content="
|
||
一些演示如何创建和组织内容的示例。
|
||
"><link rel=canonical href=https://jpanther.github.io/congo/zh-cn/docs/content-examples/><link rel=apple-touch-icon sizes=180x180 href=/congo/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=/congo/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=/congo/favicon-16x16.png><link rel=manifest href=/congo/site.webmanifest><meta property="og:title" content="内容示例"><meta property="og:description" content="一些演示如何创建和组织内容的示例。"><meta property="og:type" content="article"><meta property="og:url" content="https://jpanther.github.io/congo/zh-cn/docs/content-examples/"><meta property="article:section" content="docs"><meta property="article:published_time" content="2020-08-09T00:00:00+00:00"><meta property="article:modified_time" content="2020-08-09T00:00:00+00:00"><meta name=twitter:card content="summary"><meta name=twitter:title content="内容示例"><meta name=twitter:description content="一些演示如何创建和组织内容的示例。"><script type=application/ld+json>{"@context":"https://schema.org","@type":"Article","articleSection":"文档","name":"内容示例","headline":"内容示例","description":"一些演示如何创建和组织内容的示例。","abstract":"是时候通过一些演示示例将所有内容整合起来，展示如何创建和组织内容了。","inLanguage":"zh-CN","url":"https:\/\/jpanther.github.io\/congo\/zh-cn\/docs\/content-examples\/","author":{"@type":"Person","name":""},"copyrightYear":"2020","dateCreated":"2020-08-09T00:00:00\u002b00:00","datePublished":"2020-08-09T00:00:00\u002b00:00","dateModified":"2020-08-09T00:00:00\u002b00:00","keywords":["content","example"],"mainEntityOfPage":"true","wordCount":"502"}</script></head><body class="m-auto flex h-screen max-w-7xl flex-col bg-neutral px-6 text-lg leading-7 text-neutral-900 sm:px-14 md:px-24 lg:px-32 dark:bg-neutral-800 dark:text-neutral"><div id=the-top class="absolute flex self-center"><a class="-translate-y-8 rounded-b-lg bg-primary-200 px-3 py-1 text-sm focus:translate-y-0 dark:bg-neutral-600" href=#main-content><span class="pe-2 font-bold text-primary-600 dark:text-primary-400">↓</span>跳到主要内容</a></div><header class="py-6 font-semibold text-neutral-900 print:hidden sm:py-10 dark:text-neutral"><nav class="flex items-start justify-between sm:items-center"><div class="flex flex-row items-center"><a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2" rel=me href=/congo/zh-cn/>Congo</a></div><ul class="flex list-none flex-col text-end sm:flex-row"><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=/congo/zh-cn/docs/ title=文档><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2">文档</span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=/congo/zh-cn/samples/ title=内容样例><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2">示例</span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=/congo/zh-cn/users/ title=用户><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2">用户</span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=https://github.com/jpanther/congo title target=_blank><span class="group-dark:hover:text-primary-400 transition-colors group-hover:text-primary-600"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path fill="currentcolor" d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6.0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6.0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3.0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1.0-6.2-.3-40.4-.3-61.4.0.0-70 15-84.7-29.8.0.0-11.4-29.1-27.8-36.6.0.0-22.9-15.7 1.6-15.4.0.0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5.0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9.0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4.0 33.7-.3 75.4-.3 83.6.0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6.0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9.0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg></span></span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><button id=search-button-1 title="搜索 (/)">
|
||
<span class="group-dark:hover:text-primary-400 transition-colors group-hover:text-primary-600"><span class="icon relative inline-block px-1 align-text-bottom"><svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M505 442.7 405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9.0 208 0S0 93.1.0 208s93.1 208 208 208c48.3.0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9.0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7.0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7.0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg></span></span><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2"></span></button></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><div class="group relative"><button class="group-dark:hover:text-primary-400 flex w-full items-center justify-end transition-colors group-hover:text-primary-600">
|
||
<span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill="currentcolor" d="M4.545 6.714 4.11 8H3l1.862-5h1.284L8 8H6.833l-.435-1.286H4.545zm1.634-.736L5.5 3.956h-.049l-.679 2.022H6.18z"/><path fill="currentcolor" d="M0 2a2 2 0 012-2h7a2 2 0 012 2v3h3a2 2 0 012 2v7a2 2 0 01-2 2H7a2 2 0 01-2-2v-3H2A2 2 0 010 9V2zm2-1A1 1 0 001 2v7a1 1 0 001 1h7a1 1 0 001-1V2A1 1 0 009 1H2zm7.138 9.995c.193.301.402.583.63.846-.748.575-1.673 1.001-2.768 1.292.178.217.451.635.555.867 1.125-.359 2.08-.844 2.886-1.494.777.665 1.739 1.165 2.93 1.472.133-.254.414-.673.629-.89-1.125-.253-2.057-.694-2.82-1.284.681-.747 1.222-1.651 1.621-2.757H14V8h-3v1.047h.765c-.318.844-.74 1.546-1.272 2.13a6.066 6.066.0 01-.415-.492 1.988 1.988.0 01-.94.31z"/></svg></span><span class=text-sm>ZH-CN</span><span class=text-[0.6rem]><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M233.4 406.6c12.5 12.5 32.8 12.5 45.3.0l192-192c12.5-12.5 12.5-32.8.0-45.3s-32.8-12.5-45.3.0L256 338.7 86.6 169.4c-12.5-12.5-32.8-12.5-45.3.0s-12.5 32.8.0 45.3l192 192z"/></svg></span></span></button><div class="invisible w-full bg-transparent group-hover:visible"></div><div class="invisible absolute z-50 flex flex-col whitespace-nowrap rounded border border-neutral-300 bg-neutral text-start text-base shadow group-hover:visible ltr:right-0 rtl:left-0 dark:border-neutral-600 dark:bg-neutral-800"><div class="flex flex-grow"><a href=/congo/docs/content-examples/ class="w-full py-1 pe-10 ps-2 decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2">English (Australia)</a></div><div class="flex flex-grow"><a href=/congo/ja/docs/content-examples/ class="w-full py-1 pe-10 ps-2 decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2">日本語</a></div><div class="flex flex-grow"><a href=/congo/zh-cn/docs/content-examples/ class="flex w-full items-center justify-between bg-primary-100 px-2 py-1 dark:bg-primary-900">简体中文<span class="ms-2 w-6 text-primary-600 dark:text-primary-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path fill="currentcolor" d="M438.6 105.4c12.5 12.5 12.5 32.7.0 45.2l-256 256c-12.5 12.5-32.7 12.5-45.2.0L9.372 278.6c-12.496-12.5-12.496-32.7.0-45.2 12.498-12.5 32.758-12.5 45.258.0L159.1 338.7 393.4 105.4c12.5-12.52 32.7-12.52 45.2.0h0z"/></svg></span></span></a></div></div></div></li></ul></nav></header><div class="relative flex grow flex-col"><main id=main-content class=grow><article><header class=max-w-prose><ol class="text-sm text-neutral-500 print:hidden dark:text-neutral-400"><li class="hidden inline"><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/zh-cn/>欢迎使用Congo! :tada:</a><span class="px-1 text-primary-500">/</span></li><li class=inline><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/zh-cn/docs/>文档</a><span class="px-1 text-primary-500">/</span></li><li class="hidden inline"><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/zh-cn/docs/content-examples/>内容示例</a><span class="px-1 text-primary-500">/</span></li></ol><h1 class="mt-0 text-4xl font-extrabold text-neutral-900 dark:text-neutral">内容示例</h1><div class="mb-12 mt-8 text-base text-neutral-500 print:hidden dark:text-neutral-400"><div class="flex flex-row flex-wrap items-center"><span title=预计阅读>3 分钟</span><span class="px-2 text-primary-500">·</span>
|
||
<span class=mb-[2px]><a href=https://github.com/jpanther/congo/tree/dev/exampleSite/content/docs/content-examples/index.zh-cn.md class="text-lg hover:text-primary-500" rel="noopener noreferrer" target=_blank title=编辑内容><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M490.3 40.4c21.9 21.87 21.9 57.33.0 79.2l-30 30.1-98-97.98 30.1-30.06C414.3-.2135 449.7-.2135 471.6 21.66L490.3 40.4zM172.4 241.7 339.7 74.34l98 97.96L270.3 339.6C264.2 345.8 256.7 350.4 248.4 353.2l-88.8 29.6C150.1 385.6 141.5 383.4 135 376.1 128.6 370.5 126.4 361 129.2 352.4l29.6-88.8C161.6 255.3 166.2 247.8 172.4 241.7v0zM192 63.1c17.7.0 32 15.23 32 32 0 18.6-14.3 32-32 32H96c-17.67.0-32 15.2-32 32V416c0 17.7 14.33 32 32 32H352c17.7.0 32-14.3 32-32V319.1c0-16.8 14.3-32 32-32s32 15.2 32 32V416c0 53-43 96-96 96H96c-53.02.0-96-43-96-96V159.1c0-53 42.98-96 96-96h96z"/></svg></span></a></span></div></div></header><section class="prose mt-0 flex max-w-full flex-col dark:prose-invert lg:flex-row"><div class="order-first px-0 lg:order-last lg:max-w-xs lg:ps-8"><div class="toc pe-5 print:hidden lg:sticky lg:top-10"><details open class="-ms-5 mt-0 overflow-hidden rounded-lg ps-5"><summary class="-ms-5 block cursor-pointer bg-neutral-100 py-1 ps-5 text-lg font-semibold text-neutral-800 lg:hidden dark:bg-neutral-700 dark:text-neutral-100">目录</summary><div class="-ms-5 border-s border-dotted border-neutral-300 py-2 ps-5 dark:border-neutral-600"><nav id=TableOfContents><ul><li><a href=#分支页面>分支页面</a><ul><li><a href=#主页>主页</a></li><li><a href=#列表页面>列表页面</a></li><li><a href=#分类页面>分类页面</a></li></ul></li><li><a href=#单页>单页</a><ul><li><a href=#外部链接>外部链接</a></li><li><a href=#简单页面>简单页面</a></li></ul></li></ul></nav></div></details></div></div><div class="min-h-0 min-w-0 max-w-prose grow"><p>如果你按顺序阅读文档，现在应该对 Congo 中提供的所有功能和配置有所了解。本页面旨在将所有内容整合在一起，并提供一些你可能想在 Hugo 项目中使用的实际示例。</p><div class="flex rounded-md bg-primary-100 px-4 py-3 dark:bg-primary-900"><span class="pe-3 text-primary-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M506.3 417 293 53c-16.33-28-57.54-28-73.98.0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6c32.76.0 53.26-35 36.96-63zM232 168c0-13.25 10.75-24 24-24s24 10.8 24 24v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zm24 248c-17.36.0-31.44-14.08-31.44-31.44s14.07-31.44 31.44-31.44 31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg></span></span><span class=dark:text-neutral-300><strong>提示：</strong> 如果你是 Hugo 新手，请务必查阅
|
||
<a href=https://gohugo.io/content-management/page-bundles/ target=_blank rel=noreferrer>官方文档</a>，了解有关page bundles和资源概念的更多信息。</span></div><p>本页面的示例可以根据不同的情境进行调整，但希望能为你提供一些关于如何处理特定内容项格式的思路，以适应你个人项目的需要。</p><h2 id=分支页面 class="relative group">分支页面 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e5%88%86%e6%94%af%e9%a1%b5%e9%9d%a2 aria-label=锚点>#</a></span></h2><p>在 Hugo 中，分支页面包括主页、部分列表和分类页面等。需要记住的一点是，此类内容的文件名是 <strong><code>_index.md</code></strong>。</p><p>Congo 将遵循分支页面中指定的 front matter 参数，这些参数将覆盖该特定页面的默认设置。例如，在分支页面中设置 <code>title</code> 参数将允许覆盖页面标题。</p><h3 id=主页 class="relative group">主页 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e4%b8%bb%e9%a1%b5 aria-label=锚点>#</a></span></h3><table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>布局：</strong></td><td><code>layouts/index.html</code></td></tr><tr><td><strong>内容：</strong></td><td><code>content/_index.md</code></td></tr></tbody></table><p>在 Congo 中，主页是特殊的，因为其总体设计由主页布局配置参数控制。你可以在
|
||
<a href=https://jpanther.github.io/congo/zh-cn/docs/homepage-layout/>主页布局</a> 部分了解更多信息。</p><p>如果你想在这个页面上添加自定义内容，只需创建一个 <code>content/_index.md</code> 文件。然后，此文件中的任何内容都将包含在你的主页中。</p><p><strong>示例:</strong></p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"欢迎来到 Congo！"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>description</span><span class=p>:</span><span class=w> </span><span class=s2>"这是向主页添加内容的演示。"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>欢迎来到我的网站！我真的很高兴你停留在这里。</span><span class=w>
|
||
</span></span></span></code></pre></div><p><em>此示例设置了自定义标题，并在页面正文中添加了一些额外的文本。任何 Markdown 格式的文本都是可以接受的，包括短代码、图片和链接。</em></p><h3 id=列表页面 class="relative group">列表页面 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e5%88%97%e8%a1%a8%e9%a1%b5%e9%9d%a2 aria-label=锚点>#</a></span></h3><table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>布局：</strong></td><td><code>layouts/_default/list.html</code></td></tr><tr><td><strong>内容：</strong></td><td><code>content/../_index.md</code></td></tr></tbody></table><p>列表页面将其内部的所有页面分组到一个部分，并提供一种让访问者访问每个页面的方式。博客或投影集是列表页面的示例，因为它们将帖子或项目分组在一起。</p><p>创建列表页面就像在 content 文件夹中创建一个子目录一样简单。例如，要创建一个 “Projects” 部分，你将创建 <code>content/projects/</code>。然后为你的每个项目创建一个 Markdown 文件。</p><p>列表页面将默认生成，但为了自定义内容，你还应该在这个新目录中创建一个 <code>_index.md</code> 页面。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><span class=line><span class=cl>.
|
||
</span></span><span class=line><span class=cl>└── content
|
||
</span></span><span class=line><span class=cl> └── projects
|
||
</span></span><span class=line><span class=cl> ├── _index.md <span class=c1># /projects</span>
|
||
</span></span><span class=line><span class=cl> ├── first-project.md <span class=c1># /projects/first-project</span>
|
||
</span></span><span class=line><span class=cl> └── another-project
|
||
</span></span><span class=line><span class=cl> ├── index.md <span class=c1># /projects/another-project</span>
|
||
</span></span><span class=line><span class=cl> └── project.jpg
|
||
</span></span></code></pre></div><p>Hugo 将相应地为项目文件夹中的页面生成 URL。</p><p>就像主页一样，<code>_index.md</code> 文件中的内容将输出到生成的列表索引中。Congo 然后会在内容下方列出此部分中的任何页面。</p><p><strong>示例:</strong></p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"项目"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>description</span><span class=p>:</span><span class=w> </span><span class=s2>"了解我的一些项目。"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>cascade</span><span class=p>:</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w> </span><span class=nt>showReadingTime</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>这个部分包含所有我的当前项目。</span><span class=w>
|
||
</span></span></span></code></pre></div><p><em>在此示例中，使用了特殊的 <code>cascade</code> 参数来隐藏此部分中任何子页面上的阅读时间。通过这样做，任何项目页面将不显示其阅读时间。这是在整个部分中覆盖默认主题参数的好方法，而无需在每个单独页面中包含它们。</em></p><p>此站点的
|
||
<a href=https://jpanther.github.io/congo/zh-cn/samples/>样本部分</a> 是列表页面的示例。</p><h3 id=分类页面 class="relative group">分类页面 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e5%88%86%e7%b1%bb%e9%a1%b5%e9%9d%a2 aria-label=锚点>#</a></span></h3><table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>列表布局:</strong></td><td><code>layouts/_default/taxonomy.html</code></td></tr><tr><td><strong>术语布局:</strong></td><td><code>layouts/_default/term.html</code></td></tr><tr><td><strong>内容:</strong></td><td><code>content/../_index.md</code></td></tr></tbody></table><p>分类页面有两种形式 - 分类列表和分类术语。列表显示给定分类中每个术语的列表，而术语显示与给定术语相关的页面列表。</p><p>术语可能会有点混淆，所以让我们通过一个使用名为 <code>animals</code> 的分类的示例来探讨一下。</p><p>首先，在 Hugo 中使用分类，必须进行配置。这是通过在 <code>config/_default/taxonomies.toml</code> 创建配置文件并定义分类名称来完成的。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-toml data-lang=toml><span class=line><span class=cl><span class=c># config/_default/taxonomies.toml</span>
|
||
</span></span><span class=line><span class=cl>
|
||
</span></span><span class=line><span class=cl><span class=nx>animal</span> <span class=p>=</span> <span class=s2>"animals"</span>
|
||
</span></span></code></pre></div><p>Hugo 期望以它们的单数和复数形式列出分类，因此我们添加了单数 <code>animal</code> 等于复数 <code>animals</code> 来创建我们的示例分类。</p><p>现在我们的 <code>animals</code> 分类存在了，它需要被添加到各个内容项中。只需将其插入到前置元数据中：</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"Into the Lion's Den"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>description</span><span class=p>:</span><span class=w> </span><span class=s2>"This week we're learning about lions."</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>animals</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=s2>"lion"</span><span class=p>,</span><span class=w> </span><span class=s2>"cat"</span><span class=p>]</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span></code></pre></div><p>这样就在我们的 <code>animals</code> 分类中创建了两个 <em>术语</em> - <code>lion</code> 和 <code>cat</code>。</p><p>虽然此时并不明显，但 Hugo 现在将为这个新的分类生成列表和术语页面。默认情况下，可以通过 <code>/animals/</code> 访问列表，而术语页面可以在 <code>/animals/lion/</code> 和 <code>/animals/cat/</code> 找到。</p><p>列表页面将列出分类中包含的所有术语。在这个例子中，导航到 <code>/animals/</code> 将显示一个页面，其中包含指向各个术语页面的链接，如 “lion” 和 “cat”。</p><p>术语页面将列出该术语中包含的所有页面。这些术语列表本质上与普通的
|
||
<a href=#list-pages>列表页面</a> 相同，并以相似的方式运作。</p><p>要向分类页面添加自定义内容，只需在使用分类名称作为子目录名的内容文件夹中创建 <code>_index.md</code> 文件。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><span class=line><span class=cl>.
|
||
</span></span><span class=line><span class=cl>└── content
|
||
</span></span><span class=line><span class=cl> └── animals
|
||
</span></span><span class=line><span class=cl> ├── _index.md <span class=c1># /animals</span>
|
||
</span></span><span class=line><span class=cl> └── lion
|
||
</span></span><span class=line><span class=cl> └── _index.md <span class=c1># /animals/lion</span>
|
||
</span></span></code></pre></div><p>这些内容文件中的任何内容都将放置到生成的分类页面上。与其他内容一样，前置元数据变量可用于覆盖默认设置。通过这种方式，您可以拥有一个名为 <code>lion</code> 的标签，但可以覆盖 <code>title</code> 为 “Lion”。</p><p>要了解实际效果，请查看此站点上的
|
||
<a href=https://jpanther.github.io/congo/zh-cn/tags/>标签分类列表</a>。</p><h2 id=单页 class="relative group">单页 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e5%8d%95%e9%a1%b5 aria-label=锚点>#</a></span></h2><table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>布局：</strong></td><td><code>layouts/_default/single.html</code></td></tr><tr><td><strong>内容（独立）：</strong></td><td><code>content/../page-name.md</code></td></tr><tr><td><strong>内容（打包）：</strong></td><td><code>content/../page-name/index.md</code></td></tr></tbody></table><p>Hugo 中的单页基本上是标准内容页面。它们被定义为不包含任何子页面的页面。这可能是关于页面，或者是博客部分中的单个博客文章。</p><p>关于单页的最重要的事情是，与分支页面不同，单页应该命名为 <code>index.md</code>，<strong>没有</strong>下划线。单页还很特殊，因为它们可以在部分的顶层进行分组，并以独特的名称命名。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><span class=line><span class=cl>.
|
||
</span></span><span class=line><span class=cl>└── content
|
||
</span></span><span class=line><span class=cl> └── blog
|
||
</span></span><span class=line><span class=cl> ├── first-post.md <span class=c1># /blog/first-post</span>
|
||
</span></span><span class=line><span class=cl> ├── second-post.md <span class=c1># /blog/second-post</span>
|
||
</span></span><span class=line><span class=cl> └── third-post
|
||
</span></span><span class=line><span class=cl> ├── index.md <span class=c1># /blog/third-post</span>
|
||
</span></span><span class=line><span class=cl> └── image.jpg
|
||
</span></span></code></pre></div><p>在页面中包含资产，比如图片，应该使用页面包。页面包使用带有 <code>index.md</code> 文件的子目录创建。将资产与内容一起分组到自己的目录中是重要的，因为许多 shortcodes 和其他主题逻辑假定资源与页面一起打包。</p><p><strong>示例:</strong></p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"我的第一篇博客文章"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>date</span><span class=p>:</span><span class=w> </span><span class=ld>2022-01-25</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>description</span><span class=p>:</span><span class=w> </span><span class=s2>"欢迎来到我的博客！"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>summary</span><span class=p>:</span><span class=w> </span><span class=s2>"了解更多关于我以及我为什么开始写这个博客的信息。"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>tags</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=s2>"欢迎"</span><span class=p>,</span><span class=w> </span><span class=s2>"新"</span><span class=p>,</span><span class=w> </span><span class=s2>"关于"</span><span class=p>,</span><span class=w> </span><span class=s2>"第一篇"</span><span class=p>]</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>_这_ 是我的博客文章的内容。</span><span class=w>
|
||
</span></span></span></code></pre></div><p>单页有各种可以用于自定义显示方式的
|
||
<a href=https://jpanther.github.io/congo/zh-cn/docs/front-matter/>前置元数据</a> 参数。</p><h3 id=外部链接 class="relative group">外部链接 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e5%a4%96%e9%83%a8%e9%93%be%e6%8e%a5 aria-label=锚点>#</a></span></h3><p>Congo 具有一个特殊功能，允许外部页面的链接出现在文章列表中。如果您在第三方网站（如 Medium）上有内容，或者有研究论文希望链接，而不想在 Hugo 站点中复制内容，这将非常有用。</p><p>要创建外部链接文章，需要设置一些特殊的前置元数据：</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"我的 Medium 文章"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>date</span><span class=p>:</span><span class=w> </span><span class=ld>2022-01-25</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>externalUrl</span><span class=p>:</span><span class=w> </span><span class=s2>"https://medium.com/"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>summary</span><span class=p>:</span><span class=w> </span><span class=s2>"我在 Medium 上写了一篇文章。"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>showReadingTime</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>_build</span><span class=p>:</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w> </span><span class=nt>render</span><span class=p>:</span><span class=w> </span><span class=s2>"false"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w> </span><span class=nt>list</span><span class=p>:</span><span class=w> </span><span class=s2>"local"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span></code></pre></div><p>除了正常的前置元数据参数如 <code>title</code> 和 <code>summary</code> 外，<code>externalUrl</code> 参数用于告诉 Congo 这不是一篇普通文章。此处提供的 URL 将是访问者选择该文章时的目标链接。</p><p>此外，我们使用了一个特殊的 Hugo 前置元数据参数 <code>_build</code> 来阻止生成此内容的正常页面 - 因为我们正在链接到外部 URL，生成正常页面没有意义！</p><p>主题包含一个原型，使生成这些外部链接文章变得简单。只需在创建新内容时指定 <code>-k external</code>。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><span class=line><span class=cl>hugo new -k external posts/my-post.md
|
||
</span></span></code></pre></div><h3 id=简单页面 class="relative group">简单页面 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e7%ae%80%e5%8d%95%e9%a1%b5%e9%9d%a2 aria-label=锚点>#</a></span></h3><table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Layout:</strong></td><td><code>layouts/_default/simple.html</code></td></tr><tr><td><strong>Front Matter:</strong></td><td><code>layout: "simple"</code></td></tr></tbody></table><p>Congo 还包括一个专门用于简单页面的特殊布局。简单布局是一个全宽度的模板，只需将 Markdown 内容放入页面，而不包含任何特殊的主题功能。</p><p>简单布局中唯一可用的功能是面包屑和分享链接。但是，这些的行为仍然可以通过使用正常页面
|
||
<a href=https://jpanther.github.io/congo/zh-cn/docs/front-matter/>前置元数据</a> 变量进行控制。</p><p>要在特定页面上启用简单布局，请添加 <code>layout</code> 前置元数据变量，其值为 <code>"simple"</code>：</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"我的落地页"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>date</span><span class=p>:</span><span class=w> </span><span class=ld>2022-03-08</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>layout</span><span class=p>:</span><span class=w> </span><span class=s2>"simple"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>此页面内容现在是全宽度的。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=c>## 自定义布局</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>Hugo 的一个好处是它使得为整个站点、单独的部分或页面创建自定义布局变得很容易。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>布局遵循所有常规的 Hugo 模板规则，更多信息请参阅[官方 Hugo 文档](https://gohugo.io/templates/introduction/)。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=c>### 覆盖默认布局</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>上面讨论的每种内容类型都列出了用于生成每种页面类型的布局文件。如果在本地项目中创建了此文件，它将覆盖主题模板，因此可用于自定义网站的默认样式。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>例如，创建一个 `layouts/_default/single.html` 文件将允许完全自定义叶页面的布局。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=c>### 自定义部分布局</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>为个别内容部分创建自定义布局也很简单。当您想要使用特定样式列出某种类型内容的部分时，这将非常有用。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>让我们通过一个示例来创建一个自定义的“项目”页面，该页面使用特殊布局列出项目。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>为了做到这一点，使用常规的 Hugo 内容规则构建您的内容，并为您的项目创建一个新部分。此外，通过使用与内容相同的目录名称并添加一个 `list.html` 文件来为项目部分创建一个新布局。</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>```shell</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>.</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>└── content</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>│ └── projects</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>│ ├── _index.md</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>│ ├── first-project.md</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>│ └── second-project.md</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=l>└── layouts</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w> </span><span class=l>└── projects</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w> </span><span class=l>└── list.html</span><span class=w>
|
||
</span></span></span></code></pre></div><p>这个 <code>list.html</code> 文件现在将覆盖默认的列表模板，但仅适用于 <code>projects</code> 部分。在我们查看这个文件之前，让我们首先查看个别项目文件。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=cl><span class=nn>---</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class=s2>"Congo"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>date</span><span class=p>:</span><span class=w> </span><span class=ld>2021-08-11</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>icon</span><span class=p>:</span><span class=w> </span><span class=s2>"github"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>description</span><span class=p>:</span><span class=w> </span><span class=s2>"A theme for Hugo built with Tailwind CSS."</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>topics</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=s2>"Hugo"</span><span class=p>,</span><span class=w> </span><span class=s2>"Web"</span><span class=p>,</span><span class=w> </span><span class=s2>"Tailwind"</span><span class=p>]</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nt>externalUrl</span><span class=p>:</span><span class=w> </span><span class=s2>"https://github.com/jpanther/congo/"</span><span class=w>
|
||
</span></span></span><span class=line><span class=cl><span class=w></span><span class=nn>---</span><span class=w>
|
||
</span></span></span></code></pre></div><p><em>在这个示例中，我们为每个项目分配了一些元数据，然后我们可以在我们的列表模板中使用这些元数据。这里没有页面内容，但没有阻止您包含它。毕竟这是您自己的自定义模板！</em></p><p>有了定义的项目，现在我们可以创建一个列表模板，输出每个项目的详细信息。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-go data-lang=go><span class=line><span class=cl><span class=p>{{</span> <span class=nx>define</span> <span class=s>"main"</span> <span class=p>}}</span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>section</span> <span class=nx>class</span><span class=p>=</span><span class=s>"mt-8"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p>{{</span> <span class=k>range</span> <span class=p>.</span><span class=nx>Pages</span> <span class=p>}}</span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>article</span> <span class=nx>class</span><span class=p>=</span><span class=s>"pb-6"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>a</span> <span class=nx>class</span><span class=p>=</span><span class=s>"flex"</span> <span class=nx>href</span><span class=p>=</span><span class=s>"{{ .Params.externalUrl }}"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>div</span> <span class=nx>class</span><span class=p>=</span><span class=s>"mr-3 text-3xl text-neutral-300"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>span</span> <span class=nx>class</span><span class=p>=</span><span class=s>"relative inline-block align-text-bottom"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p>{{</span> <span class=nx>partial</span> <span class=s>"icon.html"</span> <span class=p>.</span><span class=nx>Params</span><span class=p>.</span><span class=nx>icon</span> <span class=p>}}</span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>span</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>div</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>div</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>h3</span> <span class=nx>class</span><span class=p>=</span><span class=s>"flex text-xl font-semibold"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p>{{</span> <span class=p>.</span><span class=nx>Title</span> <span class=p>}}</span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>h3</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=nx>p</span> <span class=nx>class</span><span class=p>=</span><span class=s>"text-sm text-neutral-400"</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p>{{</span> <span class=p>.</span><span class=nx>Description</span> <span class=p>}}</span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>p</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>div</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>a</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>article</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl> <span class=p>{{</span> <span class=nx>end</span> <span class=p>}}</span>
|
||
</span></span><span class=line><span class=cl> <span class=p><</span><span class=o>/</span><span class=nx>section</span><span class=p>></span>
|
||
</span></span><span class=line><span class=cl><span class=p>{{</span> <span class=nx>end</span> <span class=p>}}</span>
|
||
</span></span></code></pre></div><p>虽然这是一个相当简单的示例，但您可以看到它逐步处理此部分中的每个页面（即每个项目），然后输出到每个项目旁边的 HTML 链接和图标。每个项目的前置元数据用于确定显示哪些信息。</p><p>请记住，您需要确保相关的样式和类可用，这可能需要重新编译 Tailwind CSS。这在
|
||
<a href=https://jpanther.github.io/congo/zh-cn/docs/advanced-customisation/>高级自定义</a> 部分中有更详细的讨论。</p><p>在创建此类自定义模板时，最简单的方法始终是查看默认 Congo 模板的工作方式，然后将其用作指南。记住，
|
||
<a href=https://gohugo.io/templates/introduction/ target=_blank rel=noreferrer>Hugo 文档</a>也是学习有关创建模板的更多信息的绝佳资源。</p></div></section><footer class="max-w-prose pt-8 print:hidden"><div class=pt-8><hr class="border-dotted border-neutral-300 dark:border-neutral-600"><div class="flex justify-between pt-3"><span><a class="group flex" href=/congo/zh-cn/docs/partials/><span class="me-2 text-neutral-700 transition-transform group-hover:-translate-x-[2px] group-hover:text-primary-600 dark:text-neutral dark:group-hover:text-primary-400"><span class="ltr:inline rtl:hidden">←</span><span class="ltr:hidden rtl:inline">→</span></span>
|
||
<span class="flex flex-col"><span class="mt-[0.1rem] leading-6 group-hover:underline group-hover:decoration-primary-500">Partials</span>
|
||
<span class="mt-[0.1rem] text-xs text-neutral-500 dark:text-neutral-400"></span></span></a></span><span><a class="group flex text-right" href=/congo/zh-cn/docs/hosting-deployment/><span class="flex flex-col"><span class="mt-[0.1rem] leading-6 group-hover:underline group-hover:decoration-primary-500">部署</span>
|
||
<span class="mt-[0.1rem] text-xs text-neutral-500 dark:text-neutral-400"></span></span><span class="ms-2 text-neutral-700 transition-transform group-hover:-translate-x-[2px] group-hover:text-primary-600 dark:text-neutral dark:group-hover:text-primary-400"><span class="ltr:inline rtl:hidden">→</span><span class="ltr:hidden rtl:inline">←</span></span></a></span></div></div></footer></article><div class="pointer-events-none absolute bottom-0 end-0 top-[100vh] w-12"><a href=#the-top class="pointer-events-auto sticky top-[calc(100vh-5.5rem)] flex h-12 w-12 items-center justify-center rounded-full bg-neutral/50 text-xl text-neutral-700 backdrop-blur hover:text-primary-600 dark:bg-neutral-800/50 dark:text-neutral dark:hover:text-primary-400" aria-label=回到顶部 title=回到顶部>↑</a></div></main><footer class="py-10 print:hidden"><div class="flex items-center justify-between"><div><p class="text-sm text-neutral-500 dark:text-neutral-400">© 2023 Congo contributors</p><p class="text-xs text-neutral-500 dark:text-neutral-400">由 <a class="hover:underline hover:decoration-primary-400 hover:text-primary-500" href=https://gohugo.io/ target=_blank rel="noopener noreferrer">Hugo</a> & <a class="hover:underline hover:decoration-primary-400 hover:text-primary-500" href=https://github.com/jpanther/congo target=_blank rel="noopener noreferrer">Congo</a> 强力驱动</p></div><div class="flex flex-row items-center"><div class="me-14 cursor-pointer text-sm text-neutral-700 hover:text-primary-600 dark:text-neutral dark:hover:text-primary-400"><button id=appearance-switcher-0 type=button aria-label="appearance switcher"><div class="flex h-12 w-12 items-center justify-center dark:hidden" title=切换为深色模式><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M32 256C32 132.2 132.3 32 255.8 32c11.36.0 29.7 1.668 40.9 3.746 9.616 1.777 11.75 14.63 3.279 19.44C245 86.5 211.2 144.6 211.2 207.8c0 109.7 99.71 193 208.3 172.3 9.561-1.805 16.28 9.324 10.11 16.95C387.9 448.6 324.8 480 255.8 480 132.1 480 32 379.6 32 256z"/></svg></span></div><div class="hidden h-12 w-12 items-center justify-center dark:flex" title=切换为浅色模式><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M256 159.1c-53.02.0-95.1 42.98-95.1 95.1s41.2 96.9 95.1 96.9 95.1-42.98 95.1-95.1S309 159.1 256 159.1zM509.3 347l-63.2-91.9 63.15-91.01c6.332-9.125 1.104-21.74-9.826-23.72l-109-19.7-19.7-109c-1.975-10.93-14.59-16.16-23.72-9.824L256 65.89 164.1 2.736c-9.125-6.332-21.74-1.107-23.72 9.824L121.6 121.6 12.56 141.3C1.633 143.2-3.596 155.9 2.736 164.1L65.89 256 2.74 347.01c-6.332 9.125-1.105 21.74 9.824 23.72l109 19.7 19.7 109c1.975 10.93 14.59 16.16 23.72 9.824L256 446.1l91.01 63.15c9.127 6.334 21.75 1.107 23.72-9.822l19.7-109 109-19.7C510.4 368.8 515.6 356.1 509.3 347zM256 383.1c-70.69.0-127.1-57.31-127.1-127.1.0-70.69 57.31-127.1 127.1-127.1S383.1 186.2 383.1 256c0 70.7-56.4 127.1-127.1 127.1z"/></svg></span></div></button></div></div></div></footer><div id=search-wrapper class="invisible fixed inset-0 z-50 flex h-screen w-screen cursor-default flex-col bg-neutral-500/50 p-4 backdrop-blur-sm sm:p-6 md:p-[10vh] lg:p-[12vh] dark:bg-neutral-900/50" data-url=https://jpanther.github.io/congo/zh-cn/><div id=search-modal class="top-20 mx-auto flex min-h-0 w-full max-w-3xl flex-col rounded-md border border-neutral-200 bg-neutral shadow-lg dark:border-neutral-700 dark:bg-neutral-800"><header class="relative z-10 flex flex-none items-center justify-between px-2"><form class="flex min-w-0 flex-auto items-center"><div class="flex h-8 w-8 items-center justify-center text-neutral-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M505 442.7 405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9.0 208 0S0 93.1.0 208s93.1 208 208 208c48.3.0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9.0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7.0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7.0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg></span></div><input type=search id=search-query class="mx-1 flex h-12 flex-auto appearance-none bg-transparent focus:outline-dotted focus:outline-2 focus:outline-transparent" placeholder=搜索 tabindex=0></form><button id=close-search-button class="flex h-8 w-8 items-center justify-center text-neutral-700 hover:text-primary-600 dark:text-neutral dark:hover:text-primary-400" title="关闭 (Esc)">
|
||
<span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><path fill="currentcolor" d="M310.6 361.4c12.5 12.5 12.5 32.75.0 45.25C304.4 412.9 296.2 416 288 416s-16.38-3.125-22.62-9.375L160 301.3 54.63 406.6C48.38 412.9 40.19 416 32 416S15.63 412.9 9.375 406.6c-12.5-12.5-12.5-32.75.0-45.25l105.4-105.4L9.375 150.6c-12.5-12.5-12.5-32.75.0-45.25s32.75-12.5 45.25.0L160 210.8l105.4-105.4c12.5-12.5 32.75-12.5 45.25.0s12.5 32.75.0 45.25l-105.4 105.4L310.6 361.4z"/></svg></span></button></header><section class="flex-auto overflow-auto px-2"><ul id=search-results></ul></section></div></div></div></body></html> |