Reorganize software catalog
This commit is contained in:
@@ -55,15 +55,21 @@ order: -10
|
||||
1. `format: 1` — обязательное поле.
|
||||
2. `type: program` — обязательное поле.
|
||||
3. `name` — обязательное официальное название программы.
|
||||
4. `summary` — обязательное короткое описание программы на русском языке.
|
||||
5. `homepage` — необязательный URL домашней страницы.
|
||||
6. `source` — необязательный URL исходного кода.
|
||||
7. `forum` — необязательный URL темы программы на форуме.
|
||||
8. `author` — необязательное имя автора или название организации-разработчика.
|
||||
9. `screenshots` — обязательный массив путей; используй `[]`, если изображений
|
||||
4. `order` — необязательное целое число для сортировки соседних программ.
|
||||
5. `summary` — обязательное короткое описание программы на русском языке.
|
||||
6. `targets` — необязательный непустой массив целевых платформ.
|
||||
7. `homepage` — необязательный URL домашней страницы.
|
||||
8. `source` — необязательный URL исходного кода.
|
||||
9. `forum` — необязательный URL темы программы на форуме.
|
||||
10. `author` — необязательное имя автора или название организации-разработчика.
|
||||
11. `screenshots` — обязательный массив путей; используй `[]`, если изображений
|
||||
нет.
|
||||
10. `versions` — обязательный непустой массив версий.
|
||||
11. `additional_files` — необязательный массив файлов, не привязанных к версии.
|
||||
12. `versions` — обязательный непустой массив версий.
|
||||
13. `additional_files` — необязательный массив файлов, не привязанных к версии.
|
||||
|
||||
`order` работает так же, как у категорий: меньшее значение выводится раньше,
|
||||
отсутствие поля равнозначно `order: 0`. При равных значениях программы
|
||||
сортируются по названию. Располагай `order` после `name`.
|
||||
|
||||
После закрывающей строки `---` размести обязательное подробное описание
|
||||
программы на русском языке в обычном Markdown. Не добавляй в тело заголовок с
|
||||
@@ -116,6 +122,22 @@ SHA-256 не добавляй в индекс программы: они хра
|
||||
«полноценная». Храни `summary` во Front Matter и не вычисляй его автоматически
|
||||
из первого абзаца Markdown-тела.
|
||||
|
||||
### Целевые платформы
|
||||
|
||||
`targets` описывает платформы телефонов и программные среды, с которыми работает
|
||||
программа. Допустимые значения: `higold`, `egold`, `sgold`, `odm`, `brew`.
|
||||
|
||||
Не выводи платформу только из номера серии телефона. Если совместимость
|
||||
достоверно не установлена, не добавляй `targets`. Всегда перечисляй платформы
|
||||
явно; общего значения для всех платформ нет. У общей программы, не связанной с
|
||||
платформами Siemens, например редактора аудио или конвертера файлов, `targets`
|
||||
не указывай: такая программа выводится в корневой категории. Это относится и к
|
||||
конвертерам форматов конкретных моделей, если они работают только с локальными
|
||||
файлами и не взаимодействуют с телефоном.
|
||||
|
||||
J2ME не является значением `targets`. Мидлеты размещай в корневой категории
|
||||
`catalog/j2me` без `targets`; у их файлов используй `platform: j2me`.
|
||||
|
||||
Файлы, которые подходят ко всем версиям или существуют отдельно от релиза,
|
||||
помещай в `additional_files`, а не внутрь случайной версии:
|
||||
|
||||
@@ -135,6 +157,11 @@ additional_files:
|
||||
явные опечатки и очевидные грамматические ошибки.
|
||||
- Сохраняй полноту исходного описания. Не сокращай перечень возможностей до
|
||||
общего пересказа и не удаляй значимые технические подробности.
|
||||
- Не используй нейросетевой слоп: пустые вводные фразы, канцелярит, тавтологии,
|
||||
эвфемизмы и пересказ очевидного из названия. Пиши коротко и прямо, используй
|
||||
принятые технические термины. Например, пиши «кряк», а не «средство запуска
|
||||
без аппаратного ключа», и «эмулятор для Siemens Mobility Toolkit», а не
|
||||
«пакет, воспроизводящий программное окружение телефона».
|
||||
- Основное описание находится в Markdown-теле `index.md`; пиши его как обычный
|
||||
Markdown без YAML-отступов и литеральных блоков. Поля `description` версий и
|
||||
файлов остаются обычными строками YAML. Не вставляй HTML-разметку.
|
||||
|
||||
Reference in New Issue
Block a user