update readme in project ubl-settings-datetime

pull/19/head
MiraMaX166 3 years ago
parent a2ea0ee118
commit a6f3578f9d
Signed by: user-166
GPG Key ID: C58520EF14C48E3A

@ -21,7 +21,7 @@
1. **ТЕХНОЛОГИЧЕСКИЕ ТРЕБОВАНИЯ:** 1. **ТЕХНОЛОГИЧЕСКИЕ ТРЕБОВАНИЯ:**
1. Приложение разрабатывается под нужды операционной системы UBLinux 1. Приложение разрабатывается под нужды операционной системы UBLinux
1. Использование фирменного логотипа компании 1. Использование фирменного логотипа компании
1. Название приложения, техническое: **ubl-settings-datetime** 1. Название приложения, техническое: **ubl-settings-datetime** (далее **${NAME_APPLICATION}**)
1. Название приложения, публичное: **Дата и время** 1. Название приложения, публичное: **Дата и время**
1. Стек технологий: 1. Стек технологий:
1. Язык программирования: Bash или C(++) 1. Язык программирования: Bash или C(++)
@ -30,16 +30,24 @@
1. Операционная система разработки: UBLinux DB 1. Операционная система разработки: UBLinux DB
1. Структура: 1. Структура:
1. Bash/C(++): Весь функционал сосредоточен в графической части, вызовы и исполнение процедур написаны на языках Bash, C(++) 1. Bash/C(++): Весь функционал сосредоточен в графической части, вызовы и исполнение процедур написаны на языках Bash, C(++)
**/usr/bin/ubl-settings-datetime (скомпилированный бинарный файл)** **/usr/bin/${NAME_APPLICATION} (скомпилированный бинарный файл)**
1. Графическая часть, фронт 1. Графическая часть, фронт
Файл **glade** скомпилирован в бинарный файл **/usr/share/\${NAME_APPLICATION}/ui/\${NAME_APPLICATION}.glade**
1. Стили виджетов GTK 1. Стили виджетов GTK
Файл **css** скомпилирован в бинарный файл **/usr/share/\${NAME_APPLICATION}/css/\${NAME_APPLICATION}.css**
1. Элементы изображений 1. Элементы изображений
**/usr/share/ubl-settings-datetime/images/{\*.png,\*.svg}** 1. Иконки:
**/usr/share/icons/hicolor/scalable/apps/${NAME_APPLICATION}{\*.png,\*.svg}**
Файлы изображений png иконок должны иметь имена вида:
- ru.ublinux.\${NAME_APPLICATION}.svg
- ru.ublinux.\${NAME_APPLICATION}.\${NAME_ICONS}.svg
Где ${NAME_ICONS} - имя графического элемента, например: checked, warning, alert и т.д.
Файлы изображений png иконок должны генерироваться из svg файла в размеры 16, 32, 48, 64 пикселей сценарием make-файла.
1. Изображения:
**/usr/share/\${NAME_APPLICATION}/ui/{\*.png,\*.svg}**
1. Локализация En/Ru 1. Локализация En/Ru
Для локализации должен быть создан файл-шаблон ***name_programm.pot***, на его основе должны быть созданы сами ***po-файлы*** переводов на необходимые языки, через файл сборки из po-файлов компилируются ***mo-файлы*** и размещаются сценарием установки по указанному пути: Для локализации должен быть создан файл-шаблон ***${NAME_APPLICATION}.pot***, на его основе должны быть созданы сами ***po-файлы*** переводов на необходимые языки, через файл сборки из po-файлов компилируются ***mo-файлы*** и размещаются сценарием установки по указанному пути:
**/usr/share/locale/\${LANG}/LC_MESSAGES/${FILE_MO}** **/usr/share/locale/\${LANG}/LC_MESSAGES/\${FILE_MO}**
где ${LANG} - каталог с именем локали, например, "ru" или "ru_RU", где ${LANG} - каталог с именем локали, например, "ru" или "ru_RU",
\${FILE_MO} - файл локализации программы, например, "${NAME_APPLICATION}.mo" \${FILE_MO} - файл локализации программы, например, "${NAME_APPLICATION}.mo"
@ -92,11 +100,13 @@
1. Функции записи в локальный конфигурационный файл и чтения-записи в глобальный конфигурационный файл должны проходить процедуру повышения привилегий прав пользователя через polkit. 1. Функции записи в локальный конфигурационный файл и чтения-записи в глобальный конфигурационный файл должны проходить процедуру повышения привилегий прав пользователя через polkit.
1. Кнопка "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). При нажатии на кнопку происходит открытие меню с пунктами: "Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию". Загрузка текущей и глобальной конфигурации в системе через скрипт ubconfig (выполняются команды блоков "Чтение значений: из локального конфигурационного файла"), загрузка конфигурации из файла настроек ОС ublinux.ini (выполняются команды блоков "Чтение значений: из глобального конфигурационного файла"). 1. Кнопка "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). При нажатии на кнопку происходит открытие меню с пунктами: "Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию". Загрузка текущей и глобальной конфигурации в системе через скрипт ubconfig (выполняются команды блоков "Чтение значений: из локального конфигурационного файла"), загрузка конфигурации из файла настроек ОС ublinux.ini (выполняются команды блоков "Чтение значений: из глобального конфигурационного файла").
1. Кнопка "Сохранить" -> ("Сохранить глобальную и локальную конфигурацию). Сохраняет текущие настройки через скрипт ubconfig (выполняются команды блоков "Установить значение: в локальный конфигурационный файл") и в конфигурационный файл настроек ОС ublinux.ini (выполняются команды блоков "Установить значение: в глобальный конфигурационный файл"). При выборе пунктов "Сохранить глобальную конфигурацию, Сохранить локальную конфигурацию" происходит отдельное сохранение настроек. 1. Кнопка "Сохранить" -> ("Сохранить глобальную и локальную конфигурацию). Сохраняет текущие настройки через скрипт ubconfig (выполняются команды блоков "Установить значение: в локальный конфигурационный файл") и в конфигурационный файл настроек ОС ublinux.ini (выполняются команды блоков "Установить значение: в глобальный конфигурационный файл"). При выборе пунктов "Сохранить глобальную конфигурацию, Сохранить локальную конфигурацию" происходит отдельное сохранение настроек.
1. Обработчик ошибок. Встроенный небольшой обработчик кодов внутренних ошибок, который должен передавать статус возникшей ошибки в строку уведомления. Например: "Невозможно прочитать значение параметра XXXXXX!" 1. Кнопка с иконкой с выпадающим списком -> “Справка, О приложении”
1. Строка уведомлений. Цвет в зависимости от сигнала: 1. Справка - запуск браузера с переходом на ссылку:
- песочный, пиктограмма "Птичка", сообщения об удачных загрузках или сохранениях конфигураций системы. 1. локализованный (ru_RU) вариант:
- красный, пиктограмма "Восклицательный знак", сообщения об ошибках при сохранении, загрузке параметров конфигурации, при ошибках в работе программы, полученных от обработчика ошибок. https://wiki.ublinux.ru/ru/Программное_обеспечениерограммы_и_утилиты/Все/${NAME_APPLICATION} (далее ${URLWIKI})
1. Окно с выводом информации о программе: 1. локализованный (en_EN) вариант:
https://wiki.ublinux.com/ru/Программное_обеспечениерограммы_и_утилиты/Все/${NAME_APPLICATION} (далее ${URLWIKI})
1. О приложении. Открывается диалоговое окно с выводом информации о программе:
1. Заголовок окна по локализованному названию утилиты 1. Заголовок окна по локализованному названию утилиты
1. Копирайты, порядок: 1. Копирайты, порядок:
1. Иконка приложения 1. Иконка приложения
@ -107,8 +117,14 @@
1. Авторские права © ООО "Юбисофт", 2022 - $LASTYEAR 1. Авторские права © ООО "Юбисофт", 2022 - $LASTYEAR
- локализованный (en_EN) вариант: "Copyright © UBSoft LLC, 2022 - $LASTYEAR" - локализованный (en_EN) вариант: "Copyright © UBSoft LLC, 2022 - $LASTYEAR"
- где $LASTYEAR - текущий год. - где $LASTYEAR - текущий год.
1. Обработчик ошибок. Встроенный небольшой обработчик кодов внутренних ошибок, который должен передавать статус возникшей ошибки в строку уведомления. Например: "Невозможно прочитать значение параметра XXXXXX!"
1. Строка уведомлений. Цвет в зависимости от сигнала:
- песочный, пиктограмма "Птичка", сообщения об удачных загрузках или сохранениях конфигураций системы.
- красный, пиктограмма "Восклицательный знак", сообщения об ошибках при сохранении, загрузке параметров конфигурации, при ошибках в работе программы, полученных от обработчика ошибок.
1. **КОМАНДЫ** 1. **КОМАНДЫ**
1. Справка, О приложении > Домашняя страница проекта:
xdg-open ${URLWIKI} &
1. Текущие дата и время 1. Текущие дата и время
1. Чтение значения: 1. Чтение значения:
1. через средства функции на языке С(++) 1. через средства функции на языке С(++)

Loading…
Cancel
Save