mirror of https://github.com/jpanther/congo.git
1 line
108 KiB
JSON
1 line
108 KiB
JSON
|
[{"content":"","date":null,"permalink":"/congo/zh-cn/tags/docs/","section":"Tags","summary":"","title":"docs"},{"content":"","date":null,"permalink":"/congo/zh-cn/tags/new/","section":"Tags","summary":"","title":"new"},{"content":"","date":null,"permalink":"/congo/zh-cn/tags/","section":"Tags","summary":"","title":"Tags"},{"content":"尽管 Congo 2.0 包含大量变化,但主题已经经过设计,以最小化升级到最新版本所需的努力。\n话虽如此,有一些变化需要调整使用 Congo 1.x 构建的现有站点。本指南将引导你完成整个过程,并突出需要考虑的事项。\n步骤1:升级Hugo # Congo 2.0 要求最低 Hugo v0.87.0 或更高版本 Congo被设计以充分利用一些最新的Hugo功能。为避免任何问题,你应该定期保持Hugo的安装版本。\n你可以使用命令 hugo version 检查你当前的版本。请访问 Hugo文档获取适用于你平台的更新版本的信息。\n步骤2:升级Congo #升级Congo的过程取决于你如何在项目中引入主题。每种方法的说明如下。\n使用Hugo升级 使用git升级 手动升级 使用Hugo升级 #要将go模块升级到新的主版本,需要更新 modules.toml 和 go.mod 文件。在每个文件中,将主题的路径从 github.com/jpanther/congo 更新为 github.com/jpanther/congo/v2。\n然后进入你的项目目录并执行以下命令:\nhugo mod get -u 请注意,在某些情况下,由于Hugo本地缓存模块的方式,此步骤可能会出现问题。如果上述命令不起作用,请尝试使用 hugo mod clean 来清除本地缓存并重新下载任何模块。\n一旦主题已经升级,继续到 下一节。\n使用git升级 #可以使用git命令升级Git子模块。只需执行以下命令,最新版本的主题将被下载到你的本地存储库中:\ngit submodule update --remote --merge 一旦子模块升级完成,继续到 下一节。\n手动升级 #手动更新Congo需要下载主题的最新副本,并替换项目中的旧版本。\n请注意,在此过程中,您对主题文件所做的任何本地自定义将会丢失。 下载主题源代码的最新发布。\n从Github下载 解压缩存档,将文件夹重命名为 congo 并将其移动到Hugo项目根目录下的 themes/ 目录。你需要覆盖现有目录以替换所有主题文件。\n继续到 下一节。\n步骤 3:主题配置 #Congo 2.0 引入了许多新的主题配置参数。虽然主题会适应现有的版本1配置,但为了利用一些新的主题功能,你需要调整你现有的配置。\n最简单的方法是复制主题的默认配置并将其与你的现有文件进行比较。下面详细介绍了这个过程。\nLanguages.toml #为了提供多语言支持,特定于语言的主题参数已移至新的配置文件 languages.[lang-code].toml。主题附带一个模板文件 languages.en.toml,可作为参考。\n如果您不需要多语言支持,此步骤是可选的,但现在完成它将使未来的主题升级更容易。 语言配置文件遵循以下结构:\n# config/_default/languagues.en.toml languageCode = \u0026#34;en\u0026#34; languageName = \u0026#34;English\u0026#34; displayName = \u0026#34;EN\u0026#34; htmlCode = \u0026#34;en\u0026#34; weight = 1 rtl = false # Language-specific parameters go here Languages.toml #为了提供多语言支持,特定于语言的主题参数已移至新的配置文件 languages.[lang-code].toml。主题附带一个模板文件 languages.en.toml,可作为参考。\n如果您不需要多语言支持,此步骤是可选的,但现在完成它将使未来的主题升级更容易。 语言配置文件遵循以下结构:\n# config/_default/languagues.en.toml languageCode = \u0026#34;en\u0026#34; languageName = \u0026#34;English\u0026#34; displayName = \u0026#34;EN\u0026#34; htmlCode = \u0026#34;en\u0026#34; weight = 1 rtl = false # 此处放置特定于语言的参数 使用你喜欢的语言,在 config/_default/ 中创建这个新文件,然后将任何现有配置文件中的特定于语言的参数移到这个新文件中
|