Add includes/deb822.md for future population

ustclug · Apr 20, 2024 · 62d5226 · 62d5226
1 parent e0d77a0
commit 62d5226
Show file tree

Hide file tree

Showing 7 changed files with 66 additions and 35 deletions.
diff --git a/docs/debian-security.md b/docs/debian-security.md
@@ -73,6 +73,8 @@ Debian Old Old Stable, Old Stable, Stable
         如果需要使用源码仓库，可以在 Types 中添加 `deb-src`。
 
         如果需要使用 backports 软件源，可以在 Suites 中添加 `{{ release.codename }}-backports`。
+
+        --8<-- "deb822.md"
 {% endfor %}
 
 更改完 `sources.list` 文件后请运行 `sudo apt-get update` 更新索引以生效。

diff --git a/docs/debian.md b/docs/debian.md
@@ -79,6 +79,8 @@ Debian Old Stable, Stable, Testing, Unstable(sid)
         如果需要使用源码仓库，可以在 Types 中添加 `deb-src`。
 
         如果需要使用 backports 软件源，可以在 Suites 中添加 `{{ release.codename }}-backports`。
+
+        --8<-- "deb822.md"
 {% endfor %}
 
 !!! tip

diff --git a/docs/ubuntu-ports.md b/docs/ubuntu-ports.md
@@ -16,8 +16,7 @@ arm64, armhf, PowerPC, ppc64el, s390x
 
 所有 Ubuntu 当前对该架构支持的版本，包括开发版
 
-对于 Ubuntu 不再支持的版本，请参考
-`ubuntu-old-releases`
+对于 Ubuntu 不再支持的版本，请参考 [ubuntu-old-releases](ubuntu-old-releases.md)。
 
 ## 使用说明
 
@@ -30,24 +29,49 @@ arm64, armhf, PowerPC, ppc64el, s390x
 在 `/etc/apt/sources.list`
 文件中，将软件源的地址改为 `http://mirrors.ustc.edu.cn/ubuntu-ports`
 
-以下是 Ubuntu 22.04 /etc/apt/sources.list 文件的参考配置内容：
+以下是参考配置内容：
 
-    # 默认注释了源码仓库，如有需要可自行取消注释
-    deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy main restricted universe multiverse
-    # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy main main restricted universe multiverse
-    deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse
-    # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse
-    deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse
-    # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse
-    deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse
-    # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse
+{% for release in ubuntu_releases %}
+=== "Ubuntu {{ release.name }}"
 
-    # 预发布软件源，不建议启用
-    # deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-proposed main restricted universe multiverse
-    # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-proposed main restricted universe multiverse
+    === "`sources.list` 格式"
 
-更改完 `sources.list` 文件后请运行
-`sudo apt-get update` 更新索引以生效。
+        ```shell title="/etc/apt/sources.list"
+        # 默认注释了源码仓库，如有需要可自行取消注释
+        deb https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }} main restricted universe multiverse
+        # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }} main restricted universe multiverse
+
+        deb https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-security main restricted universe multiverse
+        # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-security main restricted universe multiverse
+
+        deb https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-updates main restricted universe multiverse
+        # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-updates main restricted universe multiverse
+
+        deb https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-backports main restricted universe multiverse
+        # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-backports main restricted universe multiverse
+
+        # 预发布软件源，不建议启用
+        # deb https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-proposed main restricted universe multiverse
+        # deb-src https://mirrors.ustc.edu.cn/ubuntu-ports/ {{ release.codename }}-proposed main restricted universe multiverse
+        ```
+        
+    === "DEB822 格式"
+
+        ```yaml title="/etc/apt/sources.list.d/ubuntu-ports.sources"
+        Types: deb
+        URIs: https://mirrors.ustc.edu.cn/ubuntu-ports
+        Suites: {{ release.codename }} {{ release.codename }}-updates {{ release.codename }}-backports
+        Components: main restricted universe multiverse
+        ```
+
+        如果需要使用源码仓库，可以在 `Types` 中添加 `deb-src`。
+
+        如果需要使用预发布软件源，可以在 `Suites` 中添加 `{{ release.codename }}-proposed`。
+
+        --8<-- "deb822.md"
+{% endfor %}
+
+更改完 `sources.list` 文件后请运行 `sudo apt-get update` 更新索引以生效。
 
 !!! tip
 

diff --git a/docs/ubuntu-releases.md b/docs/ubuntu-releases.md
@@ -16,17 +16,12 @@ AMD64 (x86_64), Intel x86
 
 ## 收录版本
 
-所有 Ubuntu 当前支持的版本，包括开发版，具体版本见
-<https://wiki.ubuntu.com/Releases>
+所有 Ubuntu 当前支持的版本，包括开发版，具体版本见 <https://wiki.ubuntu.com/Releases>。
 
-对于 Ubuntu 不再支持的版本，请参考
-`ubuntu-old-releases`
+对于 Ubuntu 不再支持的版本，请参考 [ubuntu-old-releases](ubuntu-old-releases.md)
 
 ## 使用说明
 
-Ubuntu 当前支持的版本的 ISO 镜像，下载请直接前往
-<https://mirrors.ustc.edu.cn/ubuntu-releases/>
+Ubuntu 当前支持的版本的 ISO 镜像，下载请直接前往 <https://mirrors.ustc.edu.cn/ubuntu-releases/>。
 
-另外 <https://mirrors.ustc.edu.cn/ubuntu-releases/ubuntu-core/> 中包含了
-Ubuntu Core 16 的 ISO，支持 AMD64, Intel x86, Raspberry Pi 2/3,
-DragonBoard 410c 等。
+另外 <https://mirrors.ustc.edu.cn/ubuntu-releases/ubuntu-core/> 中包含了 Ubuntu Core 16 的 ISO，支持 AMD64, Intel x86, Raspberry Pi 2/3, DragonBoard 410c 等。
diff --git a/docs/ubuntu.md b/docs/ubuntu.md
@@ -58,9 +58,10 @@ AMD64 (x86_64), Intel x86
 
 当然也可以直接编辑 APT 源文件（需要使用 sudo）。以下是参考配置内容：
 
-=== "`sources.list` 格式"
 {% for release in ubuntu_releases %}
-    === "Ubuntu {{ release.name }}"
+=== "Ubuntu {{ release.name }}"
+
+    === "`sources.list` 格式"
 
         ```shell title="/etc/apt/sources.list"
         # 默认注释了源码仓库，如有需要可自行取消注释
@@ -80,23 +81,28 @@ AMD64 (x86_64), Intel x86
         # deb https://mirrors.ustc.edu.cn/ubuntu/ {{ release.codename }}-proposed main restricted universe multiverse
         # deb-src https://mirrors.ustc.edu.cn/ubuntu/ {{ release.codename }}-proposed main restricted universe multiverse
         ```
-{% endfor %}
-
-=== "DEB822 格式"
-{% for release in ubuntu_releases %}
-    === "Ubuntu {{ release.name }}"
+        
+    === "DEB822 格式"
 
         ```yaml title="/etc/apt/sources.list.d/ubuntu.sources"
-        Enabled: yes
         Types: deb
         URIs: https://mirrors.ustc.edu.cn/ubuntu
-        Suites: {{ release.codename }} {{ release.codename }}-updates {{ release.codename }}-security
+        Suites: {{ release.codename }} {{ release.codename }}-updates {{ release.codename }}-backports
+        Components: main restricted universe multiverse
+
+        Types: deb
+        URIs: https://mirrors.ustc.edu.cn/ubuntu
+        Suites: {{ release.codename }}-security
         Components: main restricted universe multiverse
         ```
 
+        !!! warning "DEB822 格式包含了对 ubuntu-security 源的修改"
+
         如果需要使用源码仓库，可以在 `Types` 中添加 `deb-src`。
 
         如果需要使用预发布软件源，可以在 `Suites` 中添加 `{{ release.codename }}-proposed`。
+
+        --8<-- "deb822.md"
 {% endfor %}
 
 更改完 `sources.list` 文件后请运行 `sudo apt-get update` 更新索引以生效。

diff --git a/includes/deb822.md b/includes/deb822.md
@@ -0,0 +1 @@
+<!-- 待补充：DEB822 (.sources) 文件格式的解释 -->
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -34,6 +34,7 @@ theme:
   features:
     - content.code.annotate
     - content.code.copy
+    - content.tabs.link
     - navigation.indexes
     - navigation.sections
     - navigation.top
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		<!-- 待补充：DEB822 (.sources) 文件格式的解释 -->