Skip to content

Commit bb8aeeb

Browse files
committed
fix(feature-marking-guidelines): update format
1 parent b35e8fe commit bb8aeeb

File tree

2 files changed

+34
-18
lines changed

2 files changed

+34
-18
lines changed

content/developer/packaging/feature-marking-guidelines.md

+16-9
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,15 @@ With this set of guidelines, users may be better informed about the differences
1616
between system components and applications. This set of guidelines, by
1717
principle, only applies to pre-installed software.
1818

19+
Packaging
20+
---
21+
22+
To mark a package as AOSC OS feature components, use `PKGFTR=` in `defines`:
23+
24+
```
25+
PKGFTR=kde core ...
26+
```
27+
1928
Metadata
2029
---
2130

@@ -38,16 +47,14 @@ X-AOSC-Features: kde-graphical-environment multimedia-playback
3847

3948
### Example: aosc-os-feature-data
4049

41-
The `Functionality` field may be localised with the `-$LANG` suffix, those
42-
without a suffix will be used as the fallback (C/en_US) for systems set with
43-
languages without the necessary translations:
50+
The feature metadata is written in TOML, with support for localisation:
4451

4552
```
46-
Feature: kde-graphical-environment
47-
Functionality: KDE graphical environment
48-
Functionality-zh_CN: KDE 图形界面
53+
[kde-graphical-environment]
54+
zh_CN = "KDE 图形界面"
55+
en_US = "KDE graphical environment"
4956
50-
Feature: multimedia-playback
51-
Functionality: Multimedia playback support
52-
Functionality-zh_CN: 多媒体播放
57+
[multimedia-playback]
58+
zh_CN = "多媒体播放"
59+
en_US = "Multimedia playback"
5360
```

content/developer/packaging/feature-marking-guidelines.zh.md

+18-9
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
+++
2-
title = "AOSC OS OS 系统特性标记规范"
2+
title = "AOSC OS 系统特性标记规范"
33
description = "关键系统组件及特性的标记规范"
44
date = 2024-10-17T12:12:56.606Z
55
[taxonomies]
@@ -8,7 +8,16 @@ tags = ["dev-sys"]
88

99
本规范用于标记 Essential 级别以下的关键系统组件,并允许 oma 等前端程序充分告知用户移除相关软件包的风险(即可能影响到的系统功能及特性,详见下文)。实现该功能是为了更直观地让用户了解系统组件及额外应用程序之间的差异,本规范原则上只涉及安同 OS 预装的软件。
1010

11-
元数据更改
11+
打包指引
12+
---
13+
14+
如需在打包时标记系统特性,请在 `defines` 文件中添加 `PKGFTR=` 配置:
15+
16+
```
17+
PKGFTR=kde core ...
18+
```
19+
20+
元数据
1221
---
1322

1423
- 工具链及软件源侧:在 `Packages` 加入 `X-AOSC-Features`,列出相关的系统功能
@@ -26,14 +35,14 @@ X-AOSC-Features: kde-graphical-environment multimedia-playback
2635

2736
### 样例:aosc-os-feature-data
2837

29-
`Functionality` 条目可本地化,无后缀则匹配 C/en_US(或匹配无对应翻译的系统);后缀以 locale 语言格式(不带编码后缀)为准
38+
该数据使用 TOML 格式编写且支持本地化
3039

3140
```
32-
Feature: kde-graphical-environment
33-
Functionality: KDE graphical environment
34-
Functionality-zh_CN: KDE 图形界面
41+
[kde-graphical-environment]
42+
zh_CN = "KDE 图形界面"
43+
en_US = "KDE graphical environment"
3544
36-
Feature: multimedia-playback
37-
Functionality: Multimedia playback support
38-
Functionality-zh_CN: 多媒体播放
45+
[multimedia-playback]
46+
zh_CN = "多媒体播放"
47+
en_US = "Multimedia playback"
3948
```

0 commit comments

Comments
 (0)