Opengist项目自定义页脚链接配置指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00888/article/details/148864415

Opengist项目自定义页脚链接配置指南

什么是Opengist自定义链接功能

Opengist作为一个代码片段管理平台，提供了灵活的页脚链接自定义功能。这项功能允许管理员在系统底部添加指向自定义静态页面或外部网站的链接，非常适合用于展示法律声明、隐私政策、使用条款等重要信息。

为什么需要自定义链接

合规性需求：许多地区要求网站必须提供法律声明和隐私政策
用户体验：方便用户快速访问相关资源
系统集成：可以链接到其他相关服务或文档

配置自定义链接的两种方式

方法一：通过YAML配置文件

在Opengist的配置文件中，可以添加如下配置项：

custom.static-links:
  - name: 法律声明
    path: legal.html
  - name: 相关服务
    path: https://example.com/service

方法二：通过环境变量

对于容器化部署等场景，可以使用环境变量配置：

OG_CUSTOM_STATIC_LINK_0_NAME="法律声明" \
OG_CUSTOM_STATIC_LINK_0_PATH=legal.html \
OG_CUSTOM_STATIC_LINK_1_NAME="相关服务" \
OG_CUSTOM_STATIC_LINK_1_PATH=https://example.com/service \
./opengist

创建自定义HTML页面

自定义HTML文件需要放置在Opengist主目录下的custom子目录中。为了保持与Opengist整体风格一致，建议使用模板语法包含系统头部和尾部：

{{ template "header" . }}

<!-- 页面内容区域 -->

{{ template "footer" . }}

最佳实践：风格一致的页面布局

以下是一个推荐的自定义页面结构模板，使用了Opengist内置的TailwindCSS类：

{{ template "header" . }}

<div class="py-10">
   <header class="pb-4">
      <div class="flex">
         <div class="flex-auto">
            <h2 class="text-2xl font-bold leading-tight">页面标题</h2>
         </div>
      </div>
   </header>
   <main>
     <h3 class="text-xl font-bold leading-tight mt-4">小节标题</h3>
     <p class="mt-4 ml-1">这里是您的正文内容...</p>
   </main>
</div>

{{ template "footer" . }}