update

Makefile

@@ -1,8 +1,8 @@
 build:
-	pelican -s pelicanconf.py
+	pelican --ignore-cache -s pelicanconf.py
 
 web:
-	pelican -s pelicanconf-web.py
+	pelican --ignore-cache -s pelicanconf-web.py
 
 clean:
 	rm -rf cache __pycache__

pelicanconf-web.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*- #
-from __future__ import unicode_literals
 import os
 
 class i18n(object):
@@ -89,6 +88,8 @@ ASCIIDOCTOR_EXTRA_OPTIONS = [
         '--attribute=figure-caption=Рис.',
         '--attribute=toc-title=Содержание',
         '--attribute=experimental',
+        '--attribute=pdf-themesdir={}/themes/pdf'.format(os.getcwd()),
+        '--attribute=pdf-theme=wiki',
 ]
 
 REPLACES = (

pelicanconf.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*- #
-from __future__ import unicode_literals
 import os
 
 class i18n(object):
@@ -13,7 +12,7 @@ class i18n(object):
     LANGUAGES = ['ru']
     NEWSTYLE = True
 
-    __name__ = 'i18n'
+    __name__ = 'pelicanconf.i18n'
 
     def register(self):
         from pelican.signals import generator_init
@@ -89,6 +88,8 @@ ASCIIDOCTOR_EXTRA_OPTIONS = [
         '--attribute=figure-caption=Рис.',
         '--attribute=toc-title=Содержание',
         '--attribute=experimental',
+        '--attribute=pdf-themesdir={}/themes/pdf'.format(os.getcwd()),
+        '--attribute=pdf-theme=wiki',
 ]
 
 REPLACES = (

themes/pdf/wiki-theme.yml

@@ -0,0 +1,8 @@
+extends: default
+page:
+  size: A4
+#  layout: portrait
+#  margin: [15mm, 20mm, 15mm, 10mm]
+image:
+  caption:
+    align: inherit

wiki/Misc/Windows/OOShutUp.adoc

@@ -7,16 +7,16 @@
 Windows{nbsp}10. Пример приведён ниже:
 
 .Экран 1
-image::oo-shutup/1.jpg[1]
+image::oo-shutup/1.jpg[1,align="center"]
 
 .Экран 2
-image::oo-shutup/2.jpg[2]
+image::oo-shutup/2.jpg[2,align="center"]
 
 .Экран 3
-image::oo-shutup/3.jpg[3]
+image::oo-shutup/3.jpg[3,align="center"]
 
 .Экран 4
-image::oo-shutup/4.jpg[4]
+image::oo-shutup/4.jpg[4,align="center"]
 
 .Экран 5
-image::oo-shutup/5.jpg[5]
+image::oo-shutup/5.jpg[5,align="center"]

wiki/Prog/Development/Настройка QtCreator.adoc

@@ -0,0 +1,87 @@
+= Настройка Qt Creator
+:title-separator: {sp}|
+:category: Linux/Программы
+:tags: Linux, Qt, QtCreator, C++,
+
+== Плагины
+
+[.text-center]
+.Справка
+image::qtcreator-setup/qtcreator20.png[qtcreator20,align="center"]
+
+{empty} +
+
+[.text-center]
+.Справка - О модулях (часть 1)
+image::qtcreator-setup/qtcreator21.png[qtcreator21,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+{empty} +
+
+[.text-center]
+.Справка - О модулях (часть 2)
+image::qtcreator-setup/qtcreator22.png[qtcreator22,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+<<<
+
+== Среда
+
+[.text-center]
+.Инструменты - Параметры - Среда - Система
+image::qtcreator-setup/qtcreator41.png[qtcreator41,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+{empty} +
+
+== Редактор
+
+[.text-center]
+.Инструменты - Параметры - Текстовый редактор - Поведение
+image::qtcreator-setup/qtcreator42.png[qtcreator42,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+<<<
+
+== C++
+
+[.text-center]
+.Инструменты - Параметры - С++ - Именование файлов
+image::qtcreator-setup/qtcreator51.png[qtcreator51,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+{empty} +
+
+== Стилизатор
+
+[.text-center]
+.Инструменты - Параметры - Стилизатор - Uncrustify
+image::qtcreator-setup/qtcreator55.png[qtcreator55,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+<<<
+
+== Сборка и запуск
+
+[.text-center]
+.Инструменты - Параметры - Сборка и запуск - Основное
+image::qtcreator-setup/qtcreator61.png[qtcreator61,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+{empty} +
+
+== To-Do
+
+[.text-center]
+.Инструменты - Параметры - To-Do
+image::qtcreator-setup/qtcreator67.png[qtcreator67,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+<<<
+
+== Импорт проекта на CMake
+
+[.text-center]
+.Импорт проекта - Настроить проект
+image::qtcreator-setup/qtcreator74.png[qtcreator74,pdfwidth=80%,scaledwidth=80%,align="center"]
+
+{empty} +
+
+== Сборка
+
+[.text-center]
+.Проект - Настройки сборки
+image::qtcreator-setup/qtcreator81.png[qtcreator81,pdfwidth=80%,scaledwidth=80%,align="center"]
+

wiki/Prog/Development/Программные проект и иерархия каталогов.adoc

@@ -0,0 +1,38 @@
+= Программный проект и иерархия каталогов
+:title-separator: {sp}|
+:category: Программирование
+:tags: Linux, программирование, cmake
+
+Для операционных систем типа Linux принят стандарт
+https://ru.wikipedia.org/wiki/FHS[FHS] («стандарт иерархии файловой
+системы»), унифицирующий местонахождение файлов и каталогов с общим
+назначением в файловой системе. Полная текущая версия стандарта
+находится http://refspecs.linuxfoundation.org/fhs.shtml[здесь].
+
+В соответствии с данным стандартом, а также принятыми в ведущих
+дистрибутивах правилами размещения исполняемых файлов в каталогах
+пользователей, можно выделить следующие типы расположения:
+
+* системная иерархия в каталоге `/usr` используется для установки
+бинарных пакетов для данного дистрибутива;
+
+* системная иерархия в каталоге `/usr/local` используется для установки
+программного обеспечения системным администратором без использования
+пакетов (не рекомендуется для использования из-за проблем поддержки
+в актуальном состоянии);
+
+* системная иерархия в каталоге `/opt` используется для установки
+стороннего программного обеспечения. В рамках данной иерархии
+предполагается, что каждый программный продукт располагается в
+собственном каталоге. При таком типе сборки обычно используются
+дополнительные методы (статическая компоновка, включение в состав
+пакета своего набора динамических библиотек) для обеспечения работы
+пакета в операционных систем с отличающимся составом библиотек
+и другим циклом обновления;
+
+* системная иерархия в домашнем каталоге пользователя не имеет
+определённого стандарта, обычно производители дистрибутивов
+предлагают использовать для исполняемых файлов каталоги
+`$HOME/bin` или `$HOME/.local/bin`.
+
+

wiki/Prog/Development/Статический анализ кода.adoc

@@ -13,14 +13,14 @@
 
 [source,sh]
 ----
-sudo apt-get install clang-tidy-6.0
+sudo apt-get install clang-tidy-10
 ----
 
 Использование:
 
 [source,sh]
 ----
-cmake "-DCMAKE_CXX_CLANG_TIDY=/usr/bin/clang-tidy-6.0" path/to/source
+cmake "-DCMAKE_CXX_CLANG_TIDY=/usr/bin/clang-tidy-10" path/to/source
 ----
 
 В каталоге проекта нужно создать файл `.clang-tidy` в формате YAML со
@@ -30,12 +30,25 @@ cmake "-DCMAKE_CXX_CLANG_TIDY=/usr/bin/clang-tidy-6.0" path/to/source
 ----
 ---
 Checks: '-*,
-  clang-diagnostic-*,
+bugprone-*,
-  readability-*,
+clang-analyzer-*,
-  modernize-*,
 cppcoreguidelines-*,
 google-*,
-  bugprone-*'
+llvm-*,
+misc-*,
+modernize-*,
+readability-*,
+performance-*,
+portability-*,
+-cppcoreguidelines-owning-memory,
+-cppcoreguidelines-avoid-magic-numbers,
+-cppcoreguidelines-pro-bounds-array-to-pointer-decay,
+-readability-magic-numbers,
+-readability-else-after-return,
+-modernize-use-trailing-return-type,
+-modernize-avoid-c-arrays,
+-performance-no-automatic-move,
+'
 CheckOptions:
   - key: readability-identifier-naming.ClassCase
     value: CamelCase
@@ -124,7 +137,7 @@ cmake -DCMAKE_LINK_WHAT_YOU_USE=TRUE ..
 
 [source,sh]
 ----
-sudo apt-get install clazy clang-6.0
+sudo apt-get install clazy clang-9
 ----
 
 Использование:
@@ -132,7 +145,6 @@ sudo apt-get install clazy clang-6.0
 [source,sh]
 ----
 CLAZY_CHECKS=level2 cmake -DCMAKE_CXX_COMPILER=clazy ..
-CLANGXX=clang++-6.0 make
+CLANGXX=clang++-9 make
 ----
 
-=== PVS-Studio

wiki/Prog/Git/Git замена адреса подмодуля.adoc

@@ -3,15 +3,35 @@
 :category: Программирование
 :tags: программирование, git,
 
-Если у подмодуля, находящегося в каталоге `thirdparty/example` нужно
+Если у подмодулей необходимо заменить адрес синхронизации и/или
-заменить адрес синхронизации и имя используемой ветки, то в каталоге с
+имя используемой ветки, то можно отредактировать в корневом
-файлом `.gitmodules`, в котором содержится информация об этом подмодуле,
+каталоге проекта файл `.gitmodules` и выполнить данный скрипт:
-нужно выполнить команды:
 
 [source,sh]
 ----
-git config --file=.gitmodules submodule.thirdparty/example.url https://github.com/username/ABC.git
+#!/bin/bash
-git config --file=.gitmodules submodule.thirdparty/example.branch new-branch-name
+
-git submodule sync --recursive
+# Замена адресов для подмодулей:
-git submodule update --init --recursive --remote
+# 1. Отредактировать файл .gitmodules
+# 2. Запустить этот скрипт
+#
+# Параметры:
+# - имя подмодуля (если присутствует, то замена
+#   адреса производится только для данного подмодуля)
+
+M="#"
+[ ! -z $1 ] && M="$1"
+
+cat .gitmodules | while read s; do
+	s=${s/\*/}
+	s=${s/path = /}
+	if [ "$M" = "#" -o "x$M" = "x$s" ]; then
+		rm -rf .git/modules/$s
+		rm -rf $s
+	fi
+done
+
+git submodule sync
+git submodule update
 ----
+

wiki/Prog/Git/Git основные команды.adoc

@@ -24,25 +24,13 @@ sudo apt-get install git
 [width="100%",cols="18%,20%,62%",options="header",]
 |===
 | Термин            | Англ                            | Определение
-|Рабочий каталог |working tree, working directory |Набор файлов в
+| Рабочий каталог   | working tree, working directory | Набор файлов в текущем каталоге
-текущем каталоге
+| Репозиторий       | repository, repo                | Контейнер, хранящий историю изменений файлов проекта
-
+| Индекс            | index, staging area             | Область между рабочим каталогом и репозиторием, в котором осуществляется подготовка к фиксации
-|Репозиторий |repository, repo |Контейнер, хранящий историю изменений
+| SHA-1             | SHA-1                           | Уникальный идентификатор, отражающий информацию об истории
-файлов проекта
-
-|Индекс |index, staging area |Область между рабочим каталогом и
-репозиторием, в котором осуществляется подготовка к фиксации
-
-|SHA-1 |SHA-1 |Уникальный идентификатор, отражающий информацию об
-истории
-
 | Ветка             | branch                          | Именованная последовательность в истории изменений
-
+| Фиксация (коммит) | commit                          | Набор файлов, записанных в историю одновременно
-|Фиксация (коммит) |commit |Набор файлов, записанных в историю
-одновременно
-
 | `HEAD`            | `HEAD`                          | Имя ссылки на последнюю фиксацию в текущей ветке
-
 | Метка             | tag                             | Именованная ссылка на некоторую фиксацию в истории
 |===
 
@@ -137,7 +125,7 @@ participant remote as "Удалённый репозиторий\n(remote reposi
 [-> workspace : <font color=red>Начало работы</font>
 activate workspace
 remote    -> local :      <font color=red>Получение изменений с сервера</font>\n<b>git fetch</b>
-remote -> local : <font color=red>Обновление подмодулей</font>\n<b>git submodule update --remote</b>
+remote    -> local :      <font color=red>Обновление подмодулей</font>\n<b>git submodule update --recursive --init</b>
 workspace <-> local :     <font color=red>Просмотр информации</font>\n<b>git status</b>
 workspace <-> local :     <font color=red>Переход на ветку master</font>\n<b>git checkout master</b>
 local     -> workspace :  <font color=red>Слияние с удалённой веткой</font>\n<b>git merge origin/master</b>
@@ -162,14 +150,9 @@ deactivate workspace
 [width="100%",cols="15%,35%,50%",options="header",]
 |===
 | Команда      | Ключи                                    | Описание
-|`git config` |`--global user.name "John Doe"` |Имя текущего
+| `git config` | `--global user.name "John Doe"`          | Имя текущего пользователя
-пользователя
+| `git config` | `--global user.email "mail@example.com"` | Почта текущего пользователя
-
-|`git config` |`--global user.email "mail@example.com"` |Почта текущего
-пользователя
-
 | `git config` | `--list`                                 | Вывод текущей конфигурации
-
 | `git config` | `--global --list`                        | Вывод глобальной конфигурации
 |===
 
@@ -179,13 +162,8 @@ deactivate workspace
 |===
 | Команда     | Ключи                          | Описание
 | `git init`  | `<dir>`                        | Создать пустой репозиторий в каталоге `<dir>`
-
+| `git clone` | `<giturl>` `<dir>`             | Создать в каталоге `<dir>` копию репозитория, находящегося по адресу `<giturl>`
-|`git clone` |`<giturl>` `<dir>` |Создать в каталоге `<dir>` копию
+| `git clone` | `--recursive <giturl>` `<dir>` | Создать в каталоге `<dir>` копию репозитория, находящегося по адресу `<giturl>`, с учётом подмодулей
-репозитория, находящегося по адресу `<giturl>`
-
-|`git clone` |`--recursive <giturl>` `<dir>` |Создать в каталоге `<dir>`
-копию репозитория, находящегося по адресу `<giturl>`, с учётом
-подмодулей
 |===
 
 == Подмодули
@@ -193,13 +171,9 @@ deactivate workspace
 [width="100%",cols="15%,25%,60%",options="header",]
 |===
 | Команда         | Ключи                         | Описание
-|`git submodule` |`add <giturl> <dir>` |Добавить в каталог `<dir>`
+| `git submodule` | `add <giturl> <dir>`          | Добавить в каталог `<dir>` текущего репозитория подмодуль, находящийся по адресу `<giturl>`
-текущего репозитория подмодуль, находящийся по адресу `<giturl>`
-
 | `git submodule` | `update --recursive --remote` | Обновить подмодули
-
+| `git submodule` | `sync --recursive`            | Заменить адреса подмодулей на указанные в файле `.gitmodules`
-|`git submodule` |`sync --recursive` |Заменить адреса подмодулей на
-указанные в файле `.gitmodules`
 |===
 
 Удаление подмодуля:
@@ -216,11 +190,8 @@ git rm <path/to/submodule>
 |===
 | Команда      | Ключи        | Описание
 | `git add`    | `<filename>` | Подготовить файл `<filename>` к фиксации
-
 | `git commit` |              | Зафиксировать подготовленные файлы
-
+| `git commit` | `-a`         | Зафиксировать все отслеживаемые файлы, которые были изменены
-|`git commit` |`-a` |Зафиксировать все отслеживаемые файлы, которые были
-изменены
 |===
 
 == Удаление
@@ -229,11 +200,8 @@ git rm <path/to/submodule>
 |===
 | Команда  | Ключи                 | Описание
 | `git rm` | `<filename>`          | Удалить файл из индекса и рабочего каталога
-
 | `git rm` | `-f <filename>`       | Принудительное удаление файла
-
+| `git rm` | `--cached <filename>` | Удаление файла из проекта, но не из рабочего каталога
-|`git rm` |`--cached <filename>` |Удаление файла из проекта, но не из
-рабочего каталога
 |===
 
 == Информация
@@ -252,15 +220,9 @@ git rm <path/to/submodule>
 |===
 | Команда      | Ключи                | Описание
 | `git remote` | `-v`                 | Список адресов удалённых репозиториев
-
 | `git branch` | `-r`                 | Список веток в удалённых репозиториях
-
+| `git remote` | `add <name> <url>`   | Создать ссылку `<name>` на удалённый репозиторий, находящийся по адресу `<url>`
-|`git remote` |`add <name> <url>` |Создать ссылку `<name>` на удалённый
+| `git remote` | `rename <old> <new>` | Переименовать ссылку `<old>` на `<new>`
-репозиторий, находящийся по адресу `<url>`
-
-|`git remote` |`rename <old> <new>` |Переименовать ссылку `<old>` на
-`<new>`
-
 | `git remote` | `rm <name>`          | Удалить ссылку `<name>`
 |===
 
@@ -273,14 +235,9 @@ git rm <path/to/submodule>
 [width="100%",cols="15%,20%,65%",options="header",]
 |===
 | Команда    | Ключи                   | Описание
-|`git push` |`<remote> <branch>` |Отправить ветку `<branch>` в удалённый
+| `git push` | `<remote> <branch>`     | Отправить ветку `<branch>` в удалённый репозиторий `<remote>`
-репозиторий `<remote>`
+| `git push` | `<remote> --all`        | Отправить все ветки в удалённый репозиторий `<remote>`
-
+| `git push` | `--d <remote> <branch>` | Удалить ветку `<branch>` из удалённого репозитория `<remote>`
-|`git push` |`<remote> --all` |Отправить все ветки в удалённый
-репозиторий `<remote>`
-
-|`git push` |`--d <remote> <branch>` |Удалить ветку `<branch>` из
-удалённого репозитория `<remote>`
 |===
 
 == Получение изменений
@@ -288,15 +245,9 @@ git rm <path/to/submodule>
 [width="100%",cols="15%,20%,65%",options="header",]
 |===
 | Команда     | Ключи               | Описание
-|`git fetch` |`<remote>` |Получить изменения из всех веток репозитория
+| `git fetch` | `<remote>`          | Получить изменения из всех веток репозитория `<remote>`, но не выполнять слияние
-`<remote>`, но не выполнять слияние
+| `git fetch` | `<remote> <branch>` | Получить изменения из ветки `<branch>` репозитория `<remote>`, но не выполнять слияние
-
+| `git merge` | `<remote>/<branch>` | Выполнить слияние с веткой `<branch>` репозитория `<remote>`
-|`git fetch` |`<remote> <branch>` |Получить изменения из ветки
-`<branch>` репозитория `<remote>`, но не выполнять слияние
-
-|`git merge` |`<remote>/<branch>` |Выполнить слияние с веткой `<branch>`
-репозитория `<remote>`
-
 | `git pull`  | `<remote>`          | Получение и слияние
 |===
 
@@ -306,19 +257,11 @@ git rm <path/to/submodule>
 |===
 |Команда |Ключи |Описание
 | `git branch`   | `-a`             | Список локальных и удалённых веток
-
 | `git branch`   |                  | Список локальных веток
-
 | `git branch`   | `<branch>`       | Создать ветку `<branch>`
-
+| `git checkout` | `<sha-1>`        | Перейти к фиксации с идентификатором `<sha-1>`
-|`git checkout` |`<sha-1>` |Перейти к фиксации с идентификатором
-`<sha-1>`
-
 | `git branch`   | `-m <old> <new>` | Переименовать ветку `<old>` в `<new>`
-
+| `git merge`    | `<branch>`       | Слить изменения из ветки `<branch>` в текущую ветку
-|`git merge` |`<branch>` |Слить изменения из ветки `<branch>` в текущую
-ветку
-
 | `git branch`   | `-d <branch>`    | Удалить ветку `<branch>`
 |===
 
@@ -328,19 +271,10 @@ git rm <path/to/submodule>
 |===
 | Команда        | Ключи             | Описание
 | `git diff`     |                   | Сравнить рабочий каталог и индекс
-
 | `git diff`     | `–-cached`        | Сравнить индекс и последнюю фиксацию
-
 | `git diff`     | `HEAD`            | Сравнить последнюю фиксацию и рабочий каталог
-
 | `git diff`     | `--stat`          | Краткий вывод результатов
-
+| `git diff`     | `<sha-1> <sha-1>` | Сравнить две точки с указанными идентификаторами
-|`git diff` |`<sha-1> <sha-1>` |Сравнить две точки с указанными
+| `git diff`     | `<dir>` `<file>`  | Сравнивать только указанный каталог `<dir>` или файл `<file>`
-идентификаторами
+| `git difftool` |                   | Отобразить результаты сравнения в программе, определяемой переменной `diff.tool`
-
-|`git diff` |`<dir>` `<file>` |Сравнивать только указанный каталог
-`<dir>` или файл `<file>`
-
-|`git difftool` | |Отобразить результаты сравнения в программе,
-определяемой переменной `diff.tool`
 |===

wiki/Prog/Lang/CPP/Qt/Qt обмен бинарными данными с БД.adoc

@@ -19,11 +19,16 @@ CREATE TABLE example (
 ----
 const char cart[] = {0x04, 0x43, 0x00, 0x9A};
 QByteArray binDataArray(QByteArray::fromRawData(cart, 4));
-QSqlQuery query;
+QSqlQuery query1;
-query.prepare(QString("INSERT INTO example (id, bin_data) VALUES(:id, :bin_data)");
+query1.prepare(QString("INSERT INTO example (id, bin_data) VALUES(:id, :bin_data)");
-query.bindValue(":id", 10, QSql::In);
+query1.bindValue(":id", 10, QSql::In);
-query.bindValue(":bin_data", binDataArray, QSql::In | QSql::Binary);
+query1.bindValue(":bin_data", binDataArray, QSql::In | QSql::Binary);
-query.exec();
+query1.exec();
+
+QSqlQuery query2;
+query2.exec(QString("INSERT INTO files VALUES(%1, %2);")
+                   .arg(18)
+                   .arg(db.driver()->formatValue(dataField)));
 ----
 
 Чтение данных: