mirror of
https://github.com/arcan1s/arcanis.me.git
synced 2025-07-23 01:19:55 +00:00
change name= to id= in <a> tags
This commit is contained in:
arcan1s
@ -8,7 +8,7 @@ title: О zshrc
|
||||
short: about-zshrc
|
||||
description: Это моя первая статья в блоге (я думаю, мне нужно что-нибудь для тестов =)). Существует множество похожих статей и, я думаю, не буду отличаться от большинства. Я просто хочу показать мой <code>.zshrc</code> и объяснить, что в нем есть и зачем оно нужно. Также, любые комментарии или дополнения приветствуются. <a href="http://archlinux.org.ru/forum/topic/12752/" title="Тема на форуме">Оригинал</a> статьи.
|
||||
---
|
||||
<h2><a href="#prepare" class="anchor" name="prepare"><span class="octicon octicon-link"></span></a>Подготовка</h2>
|
||||
<h2><a href="#prepare" class="anchor" id="prepare"><span class="octicon octicon-link"></span></a>Подготовка</h2>
|
||||
<p>Сначала установите необходимый минимум:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -17,7 +17,7 @@ pacman -Sy pkgfile zsh zsh-completions zsh-syntax-highlighting
|
||||
|
||||
<p><a href="https://www.archlinux.org/packages/pkgfile/" title="Пакет Archlinux">pkgfile</a> очень полезная утилита. Данная команда также установит шелл, дополнения к нему и подсветку синтаксиса.</p>
|
||||
|
||||
<h2><a href="#configuration" class="anchor" name="configuration"><span class="octicon octicon-link"></span></a>Настройка шелла</h2>
|
||||
<h2><a href="#configuration" class="anchor" id="configuration"><span class="octicon octicon-link"></span></a>Настройка шелла</h2>
|
||||
<p>Все доступные опции приведены <a href="http://zsh.sourceforge.net/Doc/Release/Options.html" title="Документация zsh">здесь</a>.</p>
|
||||
|
||||
<p>Указываем файл с историей, число команд хранящихся в кэше текущего сеанса и число команд, хранящихся в файле:</p>
|
||||
@ -138,7 +138,7 @@ setopt HIST_REDUCE_BLANKS
|
||||
source /usr/share/doc/pkgfile/command-not-found.zsh
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#highlighting" class="anchor" name="highlighting"><span class="octicon octicon-link"></span></a>Подсветка синтаксиса</h2>
|
||||
<h2><a href="#highlighting" class="anchor" id="highlighting"><span class="octicon octicon-link"></span></a>Подсветка синтаксиса</h2>
|
||||
|
||||
{% highlight bash %}
|
||||
# highlighting
|
||||
@ -189,7 +189,7 @@ ZSH_HIGHLIGHT_STYLES[double-quoted-argument]='fg=yellow' # конс
|
||||
|
||||
<p>В первой строке включаем подсветку. Затем включаем основную подсветку, а также подсветку скобок и шаблонов. Шаблоны указываются ниже (<code>rm -rf *</code> в примере). Также может быть включена подсветка команд от <code>root</code> и курсора <code>cursor</code>. Синтаксис настроек понятен, <code>fg</code> цвет шрифта, <code>bg</code> цвет фона.</p>
|
||||
|
||||
<h2><a href="#prompt" class="anchor" name="prompt"><span class="octicon octicon-link"></span></a>$PROMPT и $RPROMPT</h2>
|
||||
<h2><a href="#prompt" class="anchor" id="prompt"><span class="octicon octicon-link"></span></a>$PROMPT и $RPROMPT</h2>
|
||||
<p>Я хочу использовать один файл <code>.zshrc</code> для рута и обычного пользователя:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -272,7 +272,7 @@ $returncode\
|
||||
|
||||
<p>Мой RPROMPT показывает текущее время, заряд батареи и код возврата последнего приложения. <code>precmd()</code> необходимо для автоматического обновления. Конструкция <code>$(if.true.false)</code> является условным оператором в <code>zsh</code>.</p>
|
||||
|
||||
<h2><a href="#aliases" class="anchor" name="aliases"><span class="octicon octicon-link"></span></a>Аллиасы</h2>
|
||||
<h2><a href="#aliases" class="anchor" id="aliases"><span class="octicon octicon-link"></span></a>Аллиасы</h2>
|
||||
<p><b>Копируйте только те аллиасы, которые Вам необходимы.</b> Если какой-либо аллиас использует приложение, которое не установлено, это приведет к сбою загрузки конфигурационного файла.</p>
|
||||
|
||||
<p>Полезная (или не очень) функция:</p>
|
||||
@ -364,7 +364,7 @@ alias -g h="| head"
|
||||
alias -g dn="&> /dev/null &"
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#functions" class="anchor" name="functions"><span class="octicon octicon-link"></span></a>Функции</h2>
|
||||
<h2><a href="#functions" class="anchor" id="functions"><span class="octicon octicon-link"></span></a>Функции</h2>
|
||||
<p>Специальная функция для <code>xrandr</code>:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -522,7 +522,7 @@ yatest () {
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#variables" class="anchor" name="variables"><span class="octicon octicon-link"></span></a>Переменные</h2>
|
||||
<h2><a href="#variables" class="anchor" id="variables"><span class="octicon octicon-link"></span></a>Переменные</h2>
|
||||
<p>Рекомендуется хранить свои переменные в <code>~/.zshenv</code>. Но я все храню в одном файле.</p>
|
||||
|
||||
<p>Пути, маска создаваемых файлов, редактор и пейджер:</p>
|
||||
@ -548,12 +548,12 @@ hash -d u1=/mnt/usbdev1
|
||||
hash -d u2=/mnt/usbdev2
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#screenshot" class="anchor" name="screenshot"><span class="octicon octicon-link"></span></a>Скриншот</h2>
|
||||
<h2><a href="#screenshot" class="anchor" id="screenshot"><span class="octicon octicon-link"></span></a>Скриншот</h2>
|
||||
<div class="thumbnails">
|
||||
{% assign scrdesc = "Как оно выглядит" %}
|
||||
{% assign scrname = "zshrc_demo" %}
|
||||
{% include prj_scr.html %}
|
||||
</div>
|
||||
|
||||
<h2><a href="#file" class="anchor" name="file"><span class="octicon octicon-link"></span></a>Файл</h2>
|
||||
<h2><a href="#file" class="anchor" id="file"><span class="octicon octicon-link"></span></a>Файл</h2>
|
||||
<p><a href="https://raw.github.com/arcan1s/dotfiles/master/zshrc" title="Github" type="text/plain">Мой</a> <code>.zshrc</code>.</p>
|
||||
|
||||
@ -8,10 +8,10 @@ title: Сборка Qutim с Qt5
|
||||
short: building-qutim-using-qt5
|
||||
description: Если кто-то не знает, <a href="http://qutim.org" title="Домашняя страница Qutim">Qutim</a> - мультипротокольный кросс-платформенный месседжер. Написан он на <code>CPP</code> с использованием библиотек Qt. Проект активно развивается. В этой статье речь пойдет о реализации сборки данного пакета в Archlinux с использованием библиотек Qt5 (а не Qt4, как это делают текущие пакеты в AUR).
|
||||
---
|
||||
<h2><a href="#problems" class="anchor" name="problems"><span class="octicon octicon-link"></span></a>Что не так?</h2>
|
||||
<h2><a href="#problems" class="anchor" id="problems"><span class="octicon octicon-link"></span></a>Что не так?</h2>
|
||||
<p>Да все так. Просто пакет использует для сборки систему <a href="http://qt-project.org/wiki/qbs" title="Wiki">qbs</a>, которая, на мой взгляд, немного странная. Пакет, необходимый для сборки, <a href="https://aur.archlinux.org/packages/qbs-git/" title="AUR">находится в AUR</a> (рекомендую git-версию). Когда я спросил у Andrea Scarpino (который сопровождает все KDE и Qt пакеты в официальные репозитории) по поводу переноса этого пакета в репозитории, он ответил, что всему свое время. В принципе, я с ним согласен, так как проект, судя по всему, еще немного сыроват.</p>
|
||||
|
||||
<h2><a href="#prepare" class="anchor" name="prepare"><span class="octicon octicon-link"></span></a>Подготовка</h2>
|
||||
<h2><a href="#prepare" class="anchor" id="prepare"><span class="octicon octicon-link"></span></a>Подготовка</h2>
|
||||
<p>Установим зависимости. Что-то может быть пропустил, зависимости сканировал с использованием <code>namcap</code>:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -19,7 +19,7 @@ pacman -Sy --asdeps clang git libc++abi qt5-quick1 qt5-x11extras
|
||||
yaourt -S --asdeps jreen-git qbs-git
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#qbs" class="anchor" name="qbs"><span class="octicon octicon-link"></span></a>Настройка qbs</h3>
|
||||
<h3><a href="#qbs" class="anchor" id="qbs"><span class="octicon octicon-link"></span></a>Настройка qbs</h3>
|
||||
<p>Желающие могут почитать документацию <a href="http://qt-project.org/wiki/qbs" title="Wiki">по ссылке</a> или посмотреть примеры (включены в пакет). Загвоздка в том, что эта штука использует файл настроек, который, во-первых, нужно сначала сгенерировать, во-вторых, хранится в домашней директории (и только там). В теории, генерация файла настроек (<code>~/.config/QtProject/qbs.conf</code>) происходит следующим образом:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -74,7 +74,7 @@ qutim\qbs\toolchain=clang, llvm, gcc
|
||||
|
||||
<p><a href="/resources/docs/qutim-qt5-git/qbs-qutim.conf" title="Файл" type="text/plain">qbs-qutim.conf</a></p>
|
||||
|
||||
<h3><a href="#patch" class="anchor" name="patch"><span class="octicon octicon-link"></span></a>Готовим патч для исходников</h3>
|
||||
<h3><a href="#patch" class="anchor" id="patch"><span class="octicon octicon-link"></span></a>Готовим патч для исходников</h3>
|
||||
<p>Первая проблема - <code>clang</code> (по крайней мере, в Archlinux):</p>
|
||||
|
||||
{% highlight diff %}
|
||||
@ -110,7 +110,7 @@ diff -ruN qutim.orig/protocols/vkontakte/vreen/vreen.qbs qutim/protocols/vkontak
|
||||
|
||||
<p><a href="/resources/docs/qutim-qt5-git/qutim-qbs-1.1.patch" title="Файл" type="text/plain">qutim-qbs-1.1.patch</a></p>
|
||||
|
||||
<h3><a href="#sources" class="anchor" name="sources"><span class="octicon octicon-link"></span></a>Получаем исходники</h3>
|
||||
<h3><a href="#sources" class="anchor" id="sources"><span class="octicon octicon-link"></span></a>Получаем исходники</h3>
|
||||
|
||||
{% highlight bash %}
|
||||
# клонируем репозиторий
|
||||
@ -128,7 +128,7 @@ cd ..
|
||||
patch -p0 -i qutim-qbs-1.1.patch
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#build" class="anchor" name="build"><span class="octicon octicon-link"></span></a>Сборка</h2>
|
||||
<h2><a href="#build" class="anchor" id="build"><span class="octicon octicon-link"></span></a>Сборка</h2>
|
||||
|
||||
{% highlight bash %}
|
||||
cd qutim
|
||||
@ -137,7 +137,7 @@ HOME=$(pwd) qbs -j $(nproc) -d ../build release profile:qutim
|
||||
|
||||
<p>Я пытался сделать универсальный способ сборки пакета, поэтому такое странное переназначение домашней директории. Флаг <code>-j</code> указывает число потоков сборки, флаг <code>-d</code> директорию сборки, <code>release</code> тип сборки (debug, release), <code>profile</code> используемый профиль, описанный в файле настроек.</p>
|
||||
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
{% highlight bash %}
|
||||
HOME=$(pwd) sudo qbs install -d ../build --install-root "/usr" profile:qutim
|
||||
@ -145,7 +145,7 @@ HOME=$(pwd) sudo qbs install -d ../build --install-root "/usr" profile:qutim
|
||||
|
||||
<p>Из нового - указание корневого каталога (<code>--install-root</code>). Без этого пакет будет установлен в <code>/</code> (<code>/bin</code> и <code>/lib</code>).</p>
|
||||
|
||||
<h2><a href="#pkgbuild" class="anchor" name="pkgbuild"><span class="octicon octicon-link"></span></a>PKGBUILD</h2>
|
||||
<h2><a href="#pkgbuild" class="anchor" id="pkgbuild"><span class="octicon octicon-link"></span></a>PKGBUILD</h2>
|
||||
|
||||
{% highlight bash %}
|
||||
pkgname=qutim-qt5-git
|
||||
|
||||
@ -8,7 +8,7 @@ title: Изменения сайта
|
||||
short: site-changes
|
||||
description: Решил немного поиграться с сайтом. Краткий список изменений ниже.
|
||||
---
|
||||
<h2><a href="#list" class="anchor" name="list"><span class="octicon octicon-link"></span></a>Cписок изменений:</h2>
|
||||
<h2><a href="#list" class="anchor" id="list"><span class="octicon octicon-link"></span></a>Cписок изменений:</h2>
|
||||
<ul>
|
||||
<li>Арендовал домен <code>arcanis.name</code>. Теперь, как и все белые люди, имею нормальный адрес. Небольшое описание (мне, как человеку далекому от интернет-технологий, пришлось немного попариться на эту тему). Арендуем домен, подключаем услугу редактирования DNS (для Ru-center <a href="http://www.nic.ru/dns/service/dns_hosting/" title="Сервис">DNS-master</a>) - суммарно мне обошлось около 1100 рублей/год. Кладем в наш репозиторий с сайтом файл CNAME, содержащий имя желаемого домена. Идем и добавляем две записи в DNS для нашего домена:
|
||||
|
||||
|
||||
@ -8,7 +8,7 @@ title: Создание собственного репозитория
|
||||
short: creating-custom-repo
|
||||
description: Небольшая статья, посвященная созданию собственного репозитория для Archlinux.
|
||||
---
|
||||
<h2><a href="#prepare" class="anchor" name="prepare"><span class="octicon octicon-link"></span></a>Подготовка</h2>
|
||||
<h2><a href="#prepare" class="anchor" id="prepare"><span class="octicon octicon-link"></span></a>Подготовка</h2>
|
||||
<p>Для начала находим сервер и желание с ним заниматься сексом. Для простоты, лучше, чтобы там стоял Archlinux, хотя, это и не совсем обязательно (можно создать отдельный корень под Arch). Из пакетов, пожалуй, нам понадобится только два, <code>devtools</code> и сам <code>pacman</code>:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -56,7 +56,7 @@ fi
|
||||
|
||||
<p>Директории <code>${REPODIR}/{i686,x86_64}</code> для самого репозитория, <code>${PREPAREDIR}</code> - директория, где будут лежать собранные пакеты, <code>${STAGINGDIR}</code> - директория, откуда будут собираться пакеты.</p>
|
||||
|
||||
<h2><a href="#theory" class="anchor" name="theory"><span class="octicon octicon-link"></span></a>Немного теории</h2>
|
||||
<h2><a href="#theory" class="anchor" id="theory"><span class="octicon octicon-link"></span></a>Немного теории</h2>
|
||||
<p>Создаем директорию, расшариваем ее (например, по <a href="/ru/2014/03/06/site-changes/" title="Статья про изменения сайта">ftp</a>). В ней две субдиректории - <code>i686</code> и <code>x86_64</code>, для каждого типа архитектур соответственно. И наполняем их набором пакетов по Вашему усмотрению.</p>
|
||||
|
||||
<p>Процесс обновления репозитория можно разбить на следующие части:</p>
|
||||
@ -75,7 +75,7 @@ fi
|
||||
|
||||
<p>Теперь по шагам.</p>
|
||||
|
||||
<h3><a href="#pkgbuild" class="anchor" name="pkgbuild"><span class="octicon octicon-link"></span></a>Создание PKGBUILD'ов</h3>
|
||||
<h3><a href="#pkgbuild" class="anchor" id="pkgbuild"><span class="octicon octicon-link"></span></a>Создание PKGBUILD'ов</h3>
|
||||
<p>Скачаем исходники для всех нужных пакетов из AUR'а:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -83,7 +83,7 @@ cd "${STAGINGDIR}"
|
||||
yaourt -G package-name
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#building" class="anchor" name="building"><span class="octicon octicon-link"></span></a>Сборка пакетов</h3>
|
||||
<h3><a href="#building" class="anchor" id="building"><span class="octicon octicon-link"></span></a>Сборка пакетов</h3>
|
||||
<p>Автоматически соберем каждый пакет:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -132,7 +132,7 @@ username ALL=NOPASSWD: /usr/bin/staging-x86_64-build
|
||||
username ALL=NOPASSWD: /usr/bin/multilib-staging-build
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#signing" class="anchor" name="signing"><span class="octicon octicon-link"></span></a>Подпись пакетов</h3>
|
||||
<h3><a href="#signing" class="anchor" id="signing"><span class="octicon octicon-link"></span></a>Подпись пакетов</h3>
|
||||
|
||||
{% highlight bash %}
|
||||
# подпись
|
||||
@ -147,7 +147,7 @@ fi
|
||||
|
||||
<p>Для удобства рекомендую настроить <a href="https://wiki.archlinux.org/index.php/GPG#gpg-agent" title="ArchWiki">gpg-agent</a>.</p>
|
||||
|
||||
<h3><a href="#list" class="anchor" name="list"><span class="octicon octicon-link"></span></a>Создание списка пакетов</h3>
|
||||
<h3><a href="#list" class="anchor" id="list"><span class="octicon octicon-link"></span></a>Создание списка пакетов</h3>
|
||||
|
||||
{% highlight bash %}
|
||||
# создание списка пакетов
|
||||
@ -158,7 +158,7 @@ echo -e "${bwhite}[II] ${bblue}=>${cclose} i686 packages: \n${bwhite}${i686_PACK
|
||||
echo -e "${bwhite}[II] ${bblue}=>${cclose} x86_64 packages: \n${bwhite}${x86_64_PACKAGES}${cclose}"
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#updating" class="anchor" name="updating"><span class="octicon octicon-link"></span></a>Обновление репозиториев</h3>
|
||||
<h3><a href="#updating" class="anchor" id="updating"><span class="octicon octicon-link"></span></a>Обновление репозиториев</h3>
|
||||
<p>Функция для удаления пакетов из базы данных и из репозитория:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -206,7 +206,7 @@ for PACKAGE in ${x86_64_PACKAGES}; do
|
||||
done
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#clear" class="anchor" name="clear"><span class="octicon octicon-link"></span></a>Очистка</h3>
|
||||
<h3><a href="#clear" class="anchor" id="clear"><span class="octicon octicon-link"></span></a>Очистка</h3>
|
||||
|
||||
{% highlight bash %}
|
||||
# очистка
|
||||
@ -216,7 +216,7 @@ cd "${STAGINGDIR}"
|
||||
/usr/bin/rm -rf *
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#symlinks" class="anchor" name="symlinks"><span class="octicon octicon-link"></span></a>Создание симлинков</h3>
|
||||
<h3><a href="#symlinks" class="anchor" id="symlinks"><span class="octicon octicon-link"></span></a>Создание симлинков</h3>
|
||||
<p>Вы можете захотеть создать директорию, которая будет содержать симлинки на актуальные версии пакетов с именами, не содержащими версии:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -240,10 +240,10 @@ if [ ${SYMLINK} == "yes" ]; then
|
||||
fi
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#file" class="anchor" name="file"><span class="octicon octicon-link"></span></a>Файл</h3>
|
||||
<h3><a href="#file" class="anchor" id="file"><span class="octicon octicon-link"></span></a>Файл</h3>
|
||||
<p><a href="https://github.com/arcan1s/repo-scripts" title="GitHub">Скрипты</a> целиком. Скачиваем исходники для пакетов, запускаем скрипт (при необходимости, редактируем переменные) и радуемся жизни.</p>
|
||||
|
||||
<h2><a href="#using" class="anchor" name="using"><span class="octicon octicon-link"></span></a>Использование репозитория</h2>
|
||||
<h2><a href="#using" class="anchor" id="using"><span class="octicon octicon-link"></span></a>Использование репозитория</h2>
|
||||
<p>Просто добавляем в файл <code>/etc/pacman.conf</code> следующие строки:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
|
||||
@ -8,19 +8,19 @@ title: Loveless
|
||||
short: loveless
|
||||
description: На правах оффтопа, небольшая поэма из Final Fantasy VII Crisis Core.
|
||||
---
|
||||
<h2><a href="#prologue" class="anchor" name="prologue"><span class="octicon octicon-link"></span></a>Prologue</h2>
|
||||
<h2><a href="#prologue" class="anchor" id="prologue"><span class="octicon octicon-link"></span></a>Prologue</h2>
|
||||
<p>When the war of the beasts brings about the world's end<br>
|
||||
The goddess descends from the sky<br>
|
||||
Wings of light and dark spread afar<br>
|
||||
She guides us to bliss, her gift everlasting.</p>
|
||||
|
||||
<h2><a href="#acti" class="anchor" name="acti"><span class="octicon octicon-link"></span></a>Act I</h2>
|
||||
<h2><a href="#acti" class="anchor" id="acti"><span class="octicon octicon-link"></span></a>Act I</h2>
|
||||
<p>Infinite in mystery is the gift of the Goddess<br>
|
||||
We seek it thus, and take to the sky<br>
|
||||
Ripples form on the water's surface<br>
|
||||
The wandering soul knows no rest.</p>
|
||||
|
||||
<h2><a href="#actii" class="anchor" name="actii"><span class="octicon octicon-link"></span></a>Act II</h2>
|
||||
<h2><a href="#actii" class="anchor" id="actii"><span class="octicon octicon-link"></span></a>Act II</h2>
|
||||
<p>There is no hate, only joy<br>
|
||||
For you are beloved by the goddess<br>
|
||||
Hero of the dawn, Healer of worlds<br>
|
||||
@ -28,7 +28,7 @@ Dreams of the morrow hath the shattered soul<br>
|
||||
Pride is lost<br>
|
||||
Wings stripped away, the end is nigh.</p>
|
||||
|
||||
<h2><a href="#actiii" class="anchor" name="actiii"><span class="octicon octicon-link"></span></a>Act III</h2>
|
||||
<h2><a href="#actiii" class="anchor" id="actiii"><span class="octicon octicon-link"></span></a>Act III</h2>
|
||||
<p>My friend, do you fly away now?<br>
|
||||
To a world that abhors you and I?<br>
|
||||
All that awaits you is a somber morrow<br>
|
||||
@ -38,7 +38,7 @@ Is the bringer of life, the gift of the goddess<br>
|
||||
Even if the morrow is barren of promises<br>
|
||||
Nothing shall forestall my return.</p>
|
||||
|
||||
<h2><a href="#activ" class="anchor" name="activ"><span class="octicon octicon-link"></span></a>Act IV</h2>
|
||||
<h2><a href="#activ" class="anchor" id="activ"><span class="octicon octicon-link"></span></a>Act IV</h2>
|
||||
<p>My friend, the fates are cruel<br>
|
||||
There are no dreams, no honor remains<br>
|
||||
The arrow has left, the bow of the goddess<br>
|
||||
@ -50,7 +50,7 @@ Legend shall speak<br>
|
||||
Of sacrifice at world's end<br>
|
||||
The wind sails over the water's surface.</p>
|
||||
|
||||
<h2><a href="#actv" class="anchor" name="actv"><span class="octicon octicon-link"></span></a>Act V</h2>
|
||||
<h2><a href="#actv" class="anchor" id="actv"><span class="octicon octicon-link"></span></a>Act V</h2>
|
||||
<p>Even if the morrow is barren of promises<br>
|
||||
Nothing shall forestall my return<br>
|
||||
To become the dew that quenches the land<br>
|
||||
|
||||
@ -8,7 +8,7 @@ title: Приложения, которые я использую
|
||||
short: my-desktop
|
||||
description: Небольшая статья, посвященная набору приложений и расширений, которые я использую в повседневной жизни на моем домашнем компьютере.
|
||||
---
|
||||
<h2><a href="#apps" class="anchor" name="apps"><span class="octicon octicon-link"></span></a>Приложения</h2>
|
||||
<h2><a href="#apps" class="anchor" id="apps"><span class="octicon octicon-link"></span></a>Приложения</h2>
|
||||
<ul>
|
||||
<li><p><b>Shell</b> - zshrc без вариантов. Некоторое описание моих настроек шелла могут быть найдены <a href="/ru/2014/01/14/about-zshrc/" title="Статья о zshrc">тут</a>. Сами настройки хранятся <a href="https://raw.githubusercontent.com/arcan1s/dotfiles/master/zshrc" title="Файл" type="text/plain">тут</a> или <a href="https://raw.githubusercontent.com/arcan1s/dotfiles/master/zshrc_server" title="Файл" type="text/plain">тут</a>.</p></li>
|
||||
|
||||
@ -42,7 +42,7 @@ description: Небольшая статья, посвященная набор
|
||||
</ul>
|
||||
|
||||
|
||||
<h2><a href="#kde" class="anchor" name="kde"><span class="octicon octicon-link"></span></a>Настройка KDE</h2>
|
||||
<h2><a href="#kde" class="anchor" id="kde"><span class="octicon octicon-link"></span></a>Настройка KDE</h2>
|
||||
<div class="thumbnails">
|
||||
{% assign scrdesc = "Нотариально заверенный скриншот" %}
|
||||
{% assign scrname = "kde" %}
|
||||
@ -61,7 +61,7 @@ description: Небольшая статья, посвященная набор
|
||||
</div>
|
||||
|
||||
|
||||
<h2><a href="#firefox" class="anchor" name="firefox"><span class="octicon octicon-link"></span></a>Настройка Firefox</h2>
|
||||
<h2><a href="#firefox" class="anchor" id="firefox"><span class="octicon octicon-link"></span></a>Настройка Firefox</h2>
|
||||
<p>В самих настройках ничего интересного нет, я просто напишу список аддонов. Дико радует, что для того, чтобы интерфейс был минималистичным (и удобным), нужно поставить кучу плагинов.</p>
|
||||
<ul>
|
||||
<li><p><b>Adblock plus</b> - куда же без него.</p></li>
|
||||
|
||||
@ -8,15 +8,15 @@ title: Отключение baloo, gentoo-way
|
||||
short: disabling-baloo
|
||||
description: Пока ононимные онолитеги ЛОР'а ноют на тему baloo, я предпочел потратить 15 минут на то, чтобы отвязать приложения от этого чуда человеческой мысли.
|
||||
---
|
||||
<h2><a href="#disclaimer" class="anchor" name="disclaimer"><span class="octicon octicon-link"></span></a>Дисклеймер</h2>
|
||||
<h2><a href="#disclaimer" class="anchor" id="disclaimer"><span class="octicon octicon-link"></span></a>Дисклеймер</h2>
|
||||
<p>Сам этим я не пользуюсь, поскольку предпочитаю менее деструктивные методы. Однако, судя по всему, все работает без проблем, поскольку жалоб нет. Так как патч делался действительно за несколько минут, то он просто выкорчевывает все вызовы baloo из исходников (возможно, когда-нибудь я сделаю нормальный патч).</p>
|
||||
|
||||
<p>С другой стороны, я настоятельно рекомендую людям, которым по каким-либо причинам baloo не нужен, отключить его из меню настроек (добавили пункт в 4.13.1), либо воспользоваться этой <a href="http://blog.andreascarpino.it/disabling-baloo-the-arch-way/" title="Блог Скарпино">статьей</a>.</p>
|
||||
|
||||
<h2><a href="#intro" class="anchor" name="intro"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<h2><a href="#intro" class="anchor" id="intro"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<p>В Archlinux, на текущий момент (2014-05-18) от baloo, помимо <b>baloo-widgets</b>, зависит <b>gwenview</b> и <b>kdepim</b>. В версии 4.13.0, почему то, <b>kactivities</b> тоже зависел от baloo, однако, эта зависимость не требовалась явно (таким образом, достаточно было просто пересобрать его, удалив baloo из списка зависимостей).</p>
|
||||
|
||||
<h2><a href="#gwenview" class="anchor" name="gwenview"><span class="octicon octicon-link"></span></a>gwenview</h2>
|
||||
<h2><a href="#gwenview" class="anchor" id="gwenview"><span class="octicon octicon-link"></span></a>gwenview</h2>
|
||||
<p>Тут все довольно просто. Разработчики сами позаботились за нас о возможных пожеланиях простых пользователей и добавили специальный флаг:</p>
|
||||
|
||||
{% highlight cmake %}
|
||||
@ -32,8 +32,8 @@ cmake ../gwenview-${pkgver} \
|
||||
-DGWENVIEW_SEMANTICINFO_BACKEND=None
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#kdepim" class="anchor" name="kdepim"><span class="octicon octicon-link"></span></a>kdepim</h2>
|
||||
<h2><a href="#kdepim" class="anchor" id="kdepim"><span class="octicon octicon-link"></span></a>kdepim</h2>
|
||||
<p>Так как делалось все на скорую руку, то я предпочел пробежаться по исходникам с помощью grep и найти все упоминания baloo. Нужные строки (а это указания на baloo в файлах CMakeLists.txt, вызовы функций из его библиотек, объявления заголовочных файлов) просто закомментировал (в исходном коде местами пришлось добавить фейковые вызовы). Патч полностью здесь приводить не буду (он, к тому же, немного большой), а дам <a href="https://gist.github.com/arcan1s/b698bb586faef627b3bb" title="Gist">ссылку на него</a> (4.13.3). Далее просто требуется применить этот патч к исходникам и пересобрать kdepim.</p>
|
||||
|
||||
<h2><a href="#packages" class="anchor" name="packages"><span class="octicon octicon-link"></span></a>Пакеты</h2>
|
||||
<h2><a href="#packages" class="anchor" id="packages"><span class="octicon octicon-link"></span></a>Пакеты</h2>
|
||||
<p>Все пакеты для Archlinux для обеих архитектур доступны <a href="https://wiki.archlinux.org/index.php/Unofficial_user_repositories#arcanisrepo" title="ArchWiki">в моем репозитории</a>.</p>
|
||||
|
||||
@ -8,7 +8,7 @@ title: Немного об Arch User Repository
|
||||
short: about-aur
|
||||
description: Статья посвященная работе с пользовательским репозиторием Archlinux. Постарался сделать акцент на сопровождении пакетов. Данная статья, в большей степени, представляет собой компиляцию нескольких англоязычных статей Wiki и немного личного опыта. Поэтому не уверен, что в данной статье на английском языке будет толк.
|
||||
---
|
||||
<h2><a href="#aur" class="anchor" name="aur"><span class="octicon octicon-link"></span></a>AUR</h2>
|
||||
<h2><a href="#aur" class="anchor" id="aur"><span class="octicon octicon-link"></span></a>AUR</h2>
|
||||
<p>Итак, <a href="https://aur.archlinux.org/" title="AUR">Arch User Repository</a> (AUR или АУР) - это репозиторий, поддерживаемый и развиваемый практически исключительно сообществом Archlinux. Есть еще отдельные люди, называемые <a href="https://www.archlinux.org/trustedusers/" title="Доверенные пользователи">доверенными пользователями</a> (TU), на плечах которых лежит своеобразная "модерация" этого репозитория. На мой скромный взгляд, едва ли не единственное отличие Archlinux от других дистрибутивов - это наличие AUR'а. Отличие этого репозитория от обычных прежде всего в том, что он <b>не содержит</b> архивов с исходниками или собранных пакетов - только скрипт сборки (PKGBUILD) и, возможно, дополнительные текстовые файлы.</p>
|
||||
|
||||
<p>Конечно, вручную скачивать архив с сайта AUR'а, а также проверять обновления, не совсем удобно, поэтому существует <a href="https://wiki.archlinux.org/index.php/AUR_Helpers" title="ArchWiki">набор хелперов</a>. Большинство хелперов представляет собой обертку над pacman. Я выделю только два - <a href="https://aur.archlinux.org/packages/packer/" title="AUR">packer</a> - минималистичный, удобный, быстрый - и <a href="https://aur.archlinux.org/packages/yaourt/" title="AUR">yaourt</a> - на шелле, но зато более функциональный. По не особо понятным мне причинам, в русскоязычном сегменте большее распространение получил yaourt, зарубежом - packer.</p>
|
||||
@ -25,7 +25,7 @@ description: Статья посвященная работе с пользов
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2><a href="#install-from-aur" class="anchor" name="install-from-aur"><span class="octicon octicon-link"></span></a>Установка с AUR</h2>
|
||||
<h2><a href="#install-from-aur" class="anchor" id="install-from-aur"><span class="octicon octicon-link"></span></a>Установка с AUR</h2>
|
||||
<p>Для работы с AUR требуется установить группу пакетов <a href="https://www.archlinux.org/groups/x86_64/base-devel/" title="Группа пакетов Archlinux">base-devel</a>. Пакеты с этой группы, как правило, <b>не включены</b> в зависимости. Рекомендуемая установка пакетов с AUR выглядит примерно так:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -43,7 +43,7 @@ makepkg -csrf
|
||||
pacman -U foo-0.1-1-i686.pkg.tar.xz
|
||||
{% endhighlight %}
|
||||
|
||||
<h2><a href="#upload-to-aur" class="anchor" name="upload-to-aur"><span class="octicon octicon-link"></span></a>Загрузка пакета в AUR</h2>
|
||||
<h2><a href="#upload-to-aur" class="anchor" id="upload-to-aur"><span class="octicon octicon-link"></span></a>Загрузка пакета в AUR</h2>
|
||||
<p><b>Никаких</b> <code>makepkg -S</code>. С недавних пор данный метод считается устаревшим. Но обо всем по-порядку</p>
|
||||
|
||||
<p>Нам нужно загрузить архив на сайт. В этом архиве <b>должны быть</b> PKGBUILD и .AURINFO. По поводу первого я расскажу еще чуть ниже, второй генерируется автоматически. Также, там могут быть установочные скрипты (*.install), патчи, файлы лицензии (если не предоставляются апстримом с исходниками), сервисы systemd, скрипты запуска - это то, что обычно включено. <b>Никаких исходников</b>. И тем более <b>никаких бинарников</b>. (Шутки-шутками, а я помню пакет, в котором исходный код записывался с помощью <code>cat << EOF</code> прямо в тексте PKGBUILD'а.)</p>
|
||||
@ -60,10 +60,10 @@ pacman -U foo-0.1-1-i686.pkg.tar.xz
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2><a href="#maintaining" class="anchor" name="maintaining"><span class="octicon octicon-link"></span></a>Сопровождение пакетов</h2>
|
||||
<h2><a href="#maintaining" class="anchor" id="maintaining"><span class="octicon octicon-link"></span></a>Сопровождение пакетов</h2>
|
||||
<p>Если вы сопровождаете пакет и хотите его обновить, просто загрузите обновленный пакет еще раз. Читайте - и, по возможности, отвечайте - комментарии к вашему пакету, там иногда могут быть очень полезные замечания или дельные предложения. Если вы не хотите сопровождать больше ваш пакет (или нет времени), то, пожалуйста, нажмите на кнопку справа (бросить/disown), чтобы те, кто в нем заинтересован, смогли поддерживать его. Если есть пакет, который не имеет сопровождающего, и вы хотели бы им стать, вы также можете нажать на соответствующую кнопку справа в веб-интерфейсе =)</p>
|
||||
|
||||
<h2><a href="#aur-list" class="anchor" name="aur-list"><span class="octicon octicon-link"></span></a>Список рассылки AUR</h2>
|
||||
<h2><a href="#aur-list" class="anchor" id="aur-list"><span class="octicon octicon-link"></span></a>Список рассылки AUR</h2>
|
||||
<p>По любому вопросу, связанному с работой AUR вы всегда можете обратиться в <a href="https://mailman.archlinux.org/mailman/listinfo/aur-general" title="Список рассылки">список рассылки</a> <a href="mailto:aur-general@archlinux.org" title="email">aur-general (at) archlinux (dot) org</a>. На ваш вопрос ответят, вероятно, достаточно быстро; причем, ответить могут не только обычные пользователи, но и доверенные пользователи. Также, если вы вдруг неуверены в своем PKGBUILD'е, вы тоже можете всегда обратиться в список рассылки и показать свой PKGBUILD.</p>
|
||||
|
||||
<p>Существует также отдельный список <a href="https://mailman.archlinux.org/mailman/listinfo/aur-requests" title="Список рассылки">рассылки для запросов</a> <a href="mailto:aur-requests@archlinux.org" title="email">aur-requests (at) archlinux (dot) org</a>. На текущий момент (AUR 3.2.0) общение через данный список рассылки напрямую не рекомендуется - все обычные запросы должны отсылаться с использованием веб-интерфейса (<a href="https://mailman.archlinux.org/pipermail/aur-general/2014-July/029045.html" title="Тред">подробности</a>). Запросы, которые вы можете послать:
|
||||
@ -77,7 +77,7 @@ pacman -U foo-0.1-1-i686.pkg.tar.xz
|
||||
<p>Пожалуйста, пишите письма в список рассылки аккуратно. И, желательно, вежливо (а то потом будете генерировать что-то вроде <a href="http://linux.sytes.net/post/2014/05/aur-driven-by-idiots/" title="Блог">такого</a>) (мы все знаем, что мы арче-школьники, не надо нас еще раз этим тыкать, мы обидимся). Также старайтесь избегать избыточного цитирования. И - это практически требование - предоставляйте ссылки на пакеты. Хороший вариант - составление списка ссылок в конце письма, а в теле ссылаться на них таким образом <code>[1]</code>. Если не уверены в корректности запроса - посмотрите <a href="https://mailman.archlinux.org/pipermail/aur-requests/" title="Список рассылки">архив списка рассылки</a>.</p>
|
||||
|
||||
|
||||
<h2><a href="#pkgbuild" class="anchor" name="pkgbuild"><span class="octicon octicon-link"></span></a>PKGBUILD</h2>
|
||||
<h2><a href="#pkgbuild" class="anchor" id="pkgbuild"><span class="octicon octicon-link"></span></a>PKGBUILD</h2>
|
||||
<p>PKGBUILD - это, де-факто, сценарий шелла, указывающий как и почему (в смысле, зачем) собираться пакету. Он имеет 4 части:
|
||||
<ul>
|
||||
<li><b>Объявление основных переменных</b>. Об этом я расскажу чуть ниже.</li>
|
||||
@ -87,7 +87,7 @@ pacman -U foo-0.1-1-i686.pkg.tar.xz
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h3><a href="#pkgbuild-vars" class="anchor" name="pkgbuild-vars"><span class="octicon octicon-link"></span></a>Переменные PKGBUILD</h3>
|
||||
<h3><a href="#pkgbuild-vars" class="anchor" id="pkgbuild-vars"><span class="octicon octicon-link"></span></a>Переменные PKGBUILD</h3>
|
||||
<p>Основные переменные следующие:
|
||||
<ul>
|
||||
<li><b>pkgbase</b> - группа пакетов. Например, пакеты <code>python-pyqt4</code> и <code>python2-pyqt4</code> имеют одну группу <code>pyqt4</code>.</li>
|
||||
@ -108,7 +108,7 @@ pacman -U foo-0.1-1-i686.pkg.tar.xz
|
||||
|
||||
<p>Все перечисленные выше переменные указываются в заголовке PKGBUILD. К ним также можно обращаться внутри PKGBUILD'а. Дополнительно стоит упомянуть переменные <b>startdir</b> - директория, откуда запускается makepkg, <b>srcdir</b> - директория с исходниками (<code>$startdir/src</code> по умолчанию), <b>pkgdir</b> - директория с собранным пакетом (<code>$startdir/pkg/$pkgname</code> по умолчанию). <b>Не используйте</b> переменную <b>startdir</b> без крайней необходимости.</p>
|
||||
|
||||
<h3><a href="#pkgbuild-features" class="anchor" name="pkgbuild-features"><span class="octicon octicon-link"></span></a>Некоторые особенности PKGBUILD'ов</h3>
|
||||
<h3><a href="#pkgbuild-features" class="anchor" id="pkgbuild-features"><span class="octicon octicon-link"></span></a>Некоторые особенности PKGBUILD'ов</h3>
|
||||
<p>К PKGBUILD применимы все правила программирования на шелле. Например, "смешная шутка":
|
||||
|
||||
{% highlight bash %}
|
||||
@ -176,7 +176,7 @@ pkgver() {
|
||||
Также, я отмечу, что некоторые пакеты имеют свой устоявшийся формат, поэтому, зачастую, полезно поискать что-то похожее в AUR и сделать свой PKGBUILD по образу и подобию.
|
||||
</p>
|
||||
|
||||
<h2><a href="#links" class="anchor" name="links"><span class="octicon octicon-link"></span></a>Дополнительные ссылки</h2>
|
||||
<h2><a href="#links" class="anchor" id="links"><span class="octicon octicon-link"></span></a>Дополнительные ссылки</h2>
|
||||
<ul>
|
||||
<li><a href="http://pkgbuild.com/git/aur-mirror.git/" title="Зеркало">Зеркало (git)</a></li>
|
||||
<li><a href="https://wiki.archlinux.org/index.php/AUR" title="ArchWiki">ArchWiki про AUR</a></li>
|
||||
|
||||
@ -8,10 +8,10 @@ title: Написание своих дополнений для Shell. Zsh
|
||||
short: writting-own-completions-p1
|
||||
description: <figure class="img"><img src="/resources/papers/zsh_completion.png" alt="bash_completion"></figure> В данных статьях описываются некоторые основы создания файлов дополнений для собственной программы.
|
||||
---
|
||||
<h2><a href="#preamble" class="anchor" name="preamble"><span class="octicon octicon-link"></span></a>Преамбула</h2>
|
||||
<h2><a href="#preamble" class="anchor" id="preamble"><span class="octicon octicon-link"></span></a>Преамбула</h2>
|
||||
<p>В процессе разработки <a href="/ru/projects/netctl-gui" title="Страница netctl-gui">одного своего проекта</a> возникло желание добавить также файлы дополнений (только не спрашивайте зачем). Благо я как-то уже брался за написание подобных вещей, но читать что-либо тогда мне было лень, и так и не осилил.</p>
|
||||
|
||||
<h2><a href="#introduction" class="anchor" name="introduction"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<h2><a href="#introduction" class="anchor" id="introduction"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<p>Существует несколько возможных вариантов написания файла автодополнения для zsh. В случае данной статьи я остановлюсь только на одном из них, который предоставляет большие возможности и не требует больших затрат (например, работы с регулярными выражениями).</p>
|
||||
|
||||
<p>Рассмотрим на примере моего же приложения, часть справки к которому выглядит таким образом:</p>
|
||||
@ -32,7 +32,7 @@ netctl-gui [ -h | --help ] [ -e ESSID | --essid ESSID ] [ -с FILE | --config FI
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2><a href="#file" class="anchor" name="file"><span class="octicon octicon-link"></span></a>Структура файла</h2>
|
||||
<h2><a href="#file" class="anchor" id="file"><span class="octicon octicon-link"></span></a>Структура файла</h2>
|
||||
<p>В заголовке должно быть обязательно указано, что это файл дополнений и для каких приложений он служит (можно строкой, если в файле будет содержаться дополнение для нескольких команд):
|
||||
|
||||
{% highlight bash %}
|
||||
@ -68,7 +68,7 @@ esac
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#flags" class="anchor" name="flags"><span class="octicon octicon-link"></span></a>Флаги</h2>
|
||||
<h2><a href="#flags" class="anchor" id="flags"><span class="octicon octicon-link"></span></a>Флаги</h2>
|
||||
<p>Как я и говорил во введении, существует несколько способов создания подобных файлов. В частности, они различаются декларацией флагов и их дальнейшей обработкой. В данном случае я буду использовать команду <code>_arguments</code>, которая требует специфичный формат переменных. Выглядит он таким образом <code>ФЛАГ[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. Последние два поля не обязательны и, как Вы увидите чуть ниже, вовсе и не нужны в некоторых местах. Если Вы предусматриваете два флага (короткий и длинный формат) на одно действие, то формат чуть-чуть усложняется: <code>{(ФЛАГ_2)ФЛАГ_1,(ФЛАГ_1)ФЛАГ_2}[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. Замечу, что, если Вы хотите сделать дополнения для двух типов флагов, но некоторые флаги не имеют второй записи, то Вам необходимо продублировать его таким образом: <code>{ФЛАГ,ФЛАГ}[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. <code>СООБЩЕНИЕ</code> - сообщение, которое будет показано, <code>ДЕЙСТВИЕ</code> - действие, которое будет выполнено после этого флага. В случае данного туториала, <code>ДЕЙСТВИЕ</code> будет иметь вид <code>->СОСТОЯНИЕ</code>.</p>
|
||||
|
||||
<p>Итак, согласно нашим требованиям, получается такое объявление аргументов:
|
||||
@ -86,7 +86,7 @@ _netctl_gui_arglist=(
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#variables" class="anchor" name="variables"><span class="octicon octicon-link"></span></a>Массивы переменных</h2>
|
||||
<h2><a href="#variables" class="anchor" id="variables"><span class="octicon octicon-link"></span></a>Массивы переменных</h2>
|
||||
<p>В нашем случае есть два статических массива (не изменятся ни сейчас, ни через пять минут) (массивы умышленно уменьшены):
|
||||
|
||||
{% highlight bash %}
|
||||
@ -111,7 +111,7 @@ _netctl_profiles() {
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#body" class="anchor" name="body"><span class="octicon octicon-link"></span></a>Тело функции</h2>
|
||||
<h2><a href="#body" class="anchor" id="body"><span class="octicon octicon-link"></span></a>Тело функции</h2>
|
||||
<p>Помните, там выше было что-то про состояние? Оно хранится в переменной <code>$state</code>, и в теле функции делается проверка на то, чему оно равно, чтобы подобрать соответствующие действия. В начале также нужно не забыть вызвать <code>_arguments</code> с нашими флагами.
|
||||
|
||||
{% highlight bash %}
|
||||
@ -146,7 +146,7 @@ _netctl-gui() {
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#conclusion" class="anchor" name="conclusion"><span class="octicon octicon-link"></span></a>Заключение</h2>
|
||||
<h2><a href="#conclusion" class="anchor" id="conclusion"><span class="octicon octicon-link"></span></a>Заключение</h2>
|
||||
<p>Файл хранится в директории <code>/usr/share/zsh/site-functions/</code> с произвольным, в общем-то, именем с префиксом <code>_</code>. Файл примера полностью может быть найден <a href="https://raw.githubusercontent.com/arcan1s/netctl-gui/master/sources/gui/zsh-completions" title="Файл" type="text/plain">в моем репозитории</a>.</p>
|
||||
|
||||
<p>Дополнительная информация может быть найдена в репозитории <a href="https://github.com/zsh-users/zsh-completions" title="GitHub">zsh-completions</a>. Например, там есть такой <a href="https://github.com/zsh-users/zsh-completions/blob/master/zsh-completions-howto.org" title="Туториал">How-To</a>. А еще там есть много примеров.</p>
|
||||
|
||||
@ -8,10 +8,10 @@ title: Написание своих дополнений для Shell. Bash
|
||||
short: writting-own-completions-p2
|
||||
description: <figure class="img"><img src="/resources/papers/bash_completion.png" alt="bash_completion"></figure> В данных статьях описываются некоторые основы создания файлов дополнений для собственной программы.
|
||||
---
|
||||
<h2><a href="#preamble" class="anchor" name="preamble"><span class="octicon octicon-link"></span></a>Преамбула</h2>
|
||||
<h2><a href="#preamble" class="anchor" id="preamble"><span class="octicon octicon-link"></span></a>Преамбула</h2>
|
||||
<p>В процессе разработки <a href="/ru/projects/netctl-gui" title="Страница netctl-gui">одного своего проекта</a> возникло желание добавить также файлы дополнений (только не спрашивайте зачем). Благо я как-то уже брался за написание подобных вещей, но читать что-либо тогда мне было лень, и так и не осилил.</p>
|
||||
|
||||
<h2><a href="#introduction" class="anchor" name="introduction"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<h2><a href="#introduction" class="anchor" id="introduction"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<p>Bash, в <a href="/ru/2014/07/17/writting-own-completions-p1" title="Статья о дополнениях zsh">отличие от zsh</a>, требует к себе некоторого велосипедостроения в отношении дополнений. Бегло погуглив, я не нашел более-менее нормальных туториалов, потому за основу были взяты имеющиеся в системе файлы дополнений для <code>pacman</code>.</p>
|
||||
|
||||
<p>Рассмотрим на примере все того же моего приложения. Я напомню, что часть справки к которому выглядит таким образом:</p>
|
||||
@ -32,7 +32,7 @@ netctl-gui [ -h | --help ] [ -e ESSID | --essid ESSID ] [ -с FILE | --config FI
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2><a href="#file" class="anchor" name="file"><span class="octicon octicon-link"></span></a>Структура файла</h2>
|
||||
<h2><a href="#file" class="anchor" id="file"><span class="octicon octicon-link"></span></a>Структура файла</h2>
|
||||
<p>Здесь <b>все</b> переменные должны возвращать массив. Каких-либо особых форматов тут уже нет. Сначала опишем флаги, потом уже все остальные переменные. Я напомню (так как ниже я уже не буду приводить функции более подробно), что <code>_netctl_profiles()</code>, в отличие от других переменных, должна возвращать актуальный на данный момент массив:
|
||||
|
||||
{% highlight bash %}
|
||||
@ -58,7 +58,7 @@ complete -F _netctl_gui netctl-gui
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#flags" class="anchor" name="flags"><span class="octicon octicon-link"></span></a>Флаги</h2>
|
||||
<h2><a href="#flags" class="anchor" id="flags"><span class="octicon octicon-link"></span></a>Флаги</h2>
|
||||
<p>Как было сказано выше, особого формата тут нет, доступные флаги располагаются просто массивом:
|
||||
|
||||
{% highlight bash %}
|
||||
@ -79,7 +79,7 @@ _netctl_gui_arglist=(
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#variables" class="anchor" name="variables"><span class="octicon octicon-link"></span></a>Массивы переменных</h2>
|
||||
<h2><a href="#variables" class="anchor" id="variables"><span class="octicon octicon-link"></span></a>Массивы переменных</h2>
|
||||
<p>Приведу только функцию, которая в zsh выглядела таким образом:
|
||||
|
||||
{% highlight bash %}
|
||||
@ -98,7 +98,7 @@ _netctl_profiles() {
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#body" class="anchor" name="body"><span class="octicon octicon-link"></span></a>Тело функции</h2>
|
||||
<h2><a href="#body" class="anchor" id="body"><span class="octicon octicon-link"></span></a>Тело функции</h2>
|
||||
<p>За дополнение в bash отвечает переменная <code>COMPREPLY</code>. Для отслеживания текущего состояния нужно вызвать функцию <code>_get_comp_words_by_ref</code> с параметрами <code>cur</code> (текущая опция) и <code>prev</code> (предыдущая, собственно состояние). Ну и нужно несколько точек, на которых сворачивать в определенную часть case (переменные <code>want*</code>). Для генерации дополнения используется <code>compgen</code>. После флага <code>-W</code> ему подается список слов. (Есть еще флаг <code>-F</code>, который вызывает функцию, но у меня он помимо этого еще и ворнинг выдает.) Последним аргументом идет текущая строка, к которой и нужно генерировать дополнение.</p>
|
||||
|
||||
<p>Таким образом, наша функция выглядит так:
|
||||
@ -140,5 +140,5 @@ _netctl_gui() {
|
||||
|
||||
</p>
|
||||
|
||||
<h2><a href="#conclusion" class="anchor" name="conclusion"><span class="octicon octicon-link"></span></a>Заключение</h2>
|
||||
<h2><a href="#conclusion" class="anchor" id="conclusion"><span class="octicon octicon-link"></span></a>Заключение</h2>
|
||||
<p>Файл хранится в директории <code>/usr/share/bash-completion/completions/</code> с произвольным именем. Файл примера полностью может быть найден <a href="https://raw.githubusercontent.com/arcan1s/netctl-gui/master/sources/gui/bash-completions" title="Файл" type="text/plain">в моем репозитории</a>.</p>
|
||||
|
||||
@ -39,7 +39,7 @@ hastr: true
|
||||
{% endif %}
|
||||
{% assign month = post.date | date: "%Y" %}
|
||||
<i>{% include shortdate_to_ru.html %}</i> »
|
||||
<a href="#{{ post.short }}" class="anchor" name="{{ post.short }}"><span class="octicon octicon-link"></span></a>
|
||||
<a href="#{{ post.short }}" class="anchor" id="{{ post.short }}"><span class="octicon octicon-link"></span></a>
|
||||
<a href="{{ post.url }}" title="{{ post.title }}">{{ post.title }}</a> ({{ post.tags }})<br>
|
||||
{% endfor %}
|
||||
</blockquote>
|
||||
|
||||
@ -12,7 +12,7 @@ hastr: true
|
||||
<header>
|
||||
<h1>{{ page.title }}</h1>
|
||||
<h3>
|
||||
<a href="#archive" class="anchor" name="archive"><span class="octicon octicon-link"></span></a>
|
||||
<a href="#archive" class="anchor" id="archive"><span class="octicon octicon-link"></span></a>
|
||||
<a href="/ru/blog/archive" title="Архив">Архив материалов</a>
|
||||
</h3>
|
||||
</header>
|
||||
@ -20,7 +20,7 @@ hastr: true
|
||||
|
||||
{% for post in site.categories.ru limit:10 %}
|
||||
<h1>
|
||||
<a href="#{{ post.short }}" class="anchor" name="{{ post.short }}"><span class="octicon octicon-link"></span></a>
|
||||
<a href="#{{ post.short }}" class="anchor" id="{{ post.short }}"><span class="octicon octicon-link"></span></a>
|
||||
<a href="{{ post.url }}" title="{{ post.title }}">{{ post.title }}</a>
|
||||
</h1>
|
||||
<p><i>{% include shortdate_to_ru.html %}</i></p>
|
||||
|
||||
@ -31,8 +31,8 @@ title: arcanis
|
||||
</header>
|
||||
<section>
|
||||
|
||||
<h3><a href="#welcome" class="anchor" name="welcome"><span class="octicon octicon-link"></span></a>Добро пожаловать</h3>
|
||||
<h3><a href="#welcome" class="anchor" id="welcome"><span class="octicon octicon-link"></span></a>Добро пожаловать</h3>
|
||||
<p>Добро пожаловать на мою домашнюю страничку, <code>`echo $USERNAME`</code>. Обо мне Вы можете прочитать по <a href="/ru/about" title="Обо мне">ссылке</a>. К сожалению, я не знаю html/php/ruby/прочее (но я знаю Google-фу! По крайней мере, я так думаю), поэтому эта страничка может выглядеть не очень красиво. Но я старался (ну или не совсем). В блоге я буду писать какие-нибудь статьи о науке, программировании, проживании в Archlinux и, может быть, о сопровождении пакетов. Также я создам странички для некоторых из <a href="https://github.com/arcan1s" title="GitHub">моих проектов</a>.</p>
|
||||
|
||||
<h3><a href="#contact" class="anchor" name="contact"><span class="octicon octicon-link"></span></a>Контакты</h3>
|
||||
<h3><a href="#contact" class="anchor" id="contact"><span class="octicon octicon-link"></span></a>Контакты</h3>
|
||||
<p>Если у Вас есть вопрос или что-нибудь еще, Вы можете <a href="/ru/about" title="Обо мне">связаться со мной</a>. Если Вы хотите предложить пул-реквест или сообщить о баге для этих страничек, не стесняйтесь посетить <a href="https://github.com/arcan1s/arcan1s.github.io" title="Репозиторий сайта">репозиторий на GitHub</a> и сделать это.</p>
|
||||
|
||||
@ -14,7 +14,7 @@ links:
|
||||
- Пакет в <a href="https://aur.archlinux.org/packages/git-etc" title="AUR">AUR</a>
|
||||
---
|
||||
<!-- info block -->
|
||||
<h2><a href="#info" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<p>Простой демон, который создает git репозиторий в указанной директории и создает коммит в указанный промежуток времени.</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -45,23 +45,23 @@ Additional parametrs:
|
||||
See "man 1 ctrlconf" for more details
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<ul>
|
||||
{% for devel in page.developers %}
|
||||
<li>{{ devel }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
<h3><a href="#license" class="anchor" name="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<ul>
|
||||
<li>{{ page.license }}</li>
|
||||
</ul>
|
||||
<!-- end of info block -->
|
||||
|
||||
<!-- install block -->
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<ul>
|
||||
<li><p>Скачайте <a href="https://github.com/arcan1s/git-etc/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
|
||||
<li><p>Извлеките из него файлы и установите приложение:</p>
|
||||
@ -79,7 +79,7 @@ sudo ./install.sh
|
||||
<p>Если путь не указан, пакет будет установлен в <code>/</code>.</p></li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
||||
<ul>
|
||||
<li>Bash (включая awk, grep, sed)</li>
|
||||
@ -92,7 +92,7 @@ sudo ./install.sh
|
||||
<!-- end of install block -->
|
||||
|
||||
<!-- howto block -->
|
||||
<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<p>Если Вы хотите запустить демон в <code>/etc</code>, просто запустите</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -131,14 +131,14 @@ ExecStart=/usr/bin/git-etc -c /новый/путь/к/git-etc.conf
|
||||
<!-- end of howto block -->
|
||||
|
||||
<!-- config block -->
|
||||
<h2><a href="#config" class="anchor" name="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<p>Все настройки хранятся в <code>/etc/git-etc.conf</code>. После редактирования, Вы должны перезапустить демон</p>
|
||||
|
||||
{% highlight bash %}
|
||||
systemctl restart git-etc
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#options" class="anchor" name="options"><span class="octicon octicon-link"></span></a>Опции</h3>
|
||||
<h3><a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Опции</h3>
|
||||
<table>
|
||||
<tr>
|
||||
<th>DIRECTORY</th>
|
||||
@ -160,14 +160,14 @@ systemctl restart git-etc
|
||||
<!-- end of config block -->
|
||||
|
||||
<!-- gui block -->
|
||||
<h2><a href="#gui" class="anchor" name="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
<p>Control Config (<code>ctrlconf</code>) - графический интерфейс для <code>git-etc</code>, написанный на <code>Python2/PyQt4</code>. Данное приложение позволяет Вам увидеть список коммитов и изменения в файлах в данных коммитах. Также данное приложение позволит Вам откатиться на указанный коммит (все файлы, посредством <code>git reset --hard</code>, или только указанный, посредством <code>git diff && git apply</code>). Также Вы можете объединить старый и новый конфигурационные файлы (используются две
|
||||
ветки репозитория master и experimental). Приложение может потребовать привелегии root, убедитесь, что пакет <code>sudo</code> установлен.</p>
|
||||
|
||||
<h3><a href="#gui_configuration" class="anchor" name="gui_configuration"><span class="octicon octicon-link"></span></a>Настройка</h3>
|
||||
<h3><a href="#gui_configuration" class="anchor" id="gui_configuration"><span class="octicon octicon-link"></span></a>Настройка</h3>
|
||||
<p>Запустите приложение и откройте окно настроек из меню.</p>
|
||||
|
||||
<h3><a href="#screenshots" class="anchor" name="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
||||
<h3><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
||||
<div class="thumbnails">
|
||||
{% assign scrdesc = "Основное окно" %}
|
||||
{% assign scrname = "git-etc_mainwindow" %}
|
||||
|
||||
@ -116,9 +116,9 @@ groups:
|
||||
<section>
|
||||
|
||||
{% for group in page.groups %}
|
||||
<h1><a href="#{{ group.short }}" class="anchor" name="{{ group.short }}"><span class="octicon octicon-link"></span></a>{{ group.title }}</a></h1>
|
||||
<h1><a href="#{{ group.short }}" class="anchor" id="{{ group.short }}"><span class="octicon octicon-link"></span></a>{{ group.title }}</a></h1>
|
||||
{% for project in group.projects %}
|
||||
<h2><a href="#{{ project.short }}" class="anchor" name="{{ project.short }}"><span class="octicon octicon-link"></span></a>{{ project.title }}</h2>
|
||||
<h2><a href="#{{ project.short }}" class="anchor" id="{{ project.short }}"><span class="octicon octicon-link"></span></a>{{ project.title }}</h2>
|
||||
<p>{{ project.description }}</p>
|
||||
<p><ul>
|
||||
{% for link in project.links %}
|
||||
|
||||
@ -18,7 +18,7 @@ links:
|
||||
- <a href="/devs/netctl-gui-security-notes.html" title="Security">Примечания о безопасности</a>
|
||||
---
|
||||
<!-- info block -->
|
||||
<h2><a href="#info" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<p>Графическая оболочка для <code>netctl</code> (набор скриптов для поднятия сети в Arch'е). Написана на <code>CPP</code> с использованием библиотеки <code>Qt4</code>. На текущим момент умеет работать с профилями, в том числе создавать новые, а также умеет подключаться к WiFi. Также предоставляет библиотеку для взаимодействия с netctl и виджет и DataEngine для KDE.</p>
|
||||
|
||||
<p><b>ВНИМАНИЕ:</b> <a href="https://github.com/arcan1s/netctl-gui/issues/3" title="Тикет">НУЖНЫ ПЕРЕВОДЧИКИ!</a></p>
|
||||
@ -68,26 +68,26 @@ netctlgui-helper [ options ]
|
||||
-h, --help - показать справку и выход
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<ul>
|
||||
{% for devel in page.developers %}
|
||||
<li>{{ devel }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
<h3><a href="#license" class="anchor" name="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<ul>
|
||||
<li>{{ page.license }}</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#changelog" class="anchor" name="changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
|
||||
<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
|
||||
<p><a href="https://github.com/arcan1s/netctl-gui/blob/master/CHANGELOG" title="GitHub">CHANGELOG</a></p>
|
||||
<!-- end of info block -->
|
||||
|
||||
<!-- install block -->
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<ul>
|
||||
<li><p>Скачайте <a href="https://github.com/arcan1s/netctl-gui/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
|
||||
<li><p>Извлеките из него файлы и установите приложение:</p>
|
||||
@ -127,7 +127,7 @@ sudo make install
|
||||
</ul></li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
||||
<ul>
|
||||
<li>netctl</li>
|
||||
@ -142,12 +142,12 @@ sudo make install
|
||||
<!-- end of install block -->
|
||||
|
||||
<!-- howto block -->
|
||||
<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<p>Просто запустите приложение <code>netctl-gui</code>. Если потребуется (и если Вы используете KDE), можете добавить виджет <code>netctl</code>, предоставляемый приложением.</p>
|
||||
<!-- end of howto block -->
|
||||
|
||||
<!-- config block -->
|
||||
<h2><a href="#config" class="anchor" name="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<p>Рекомендуется использовать графический интерфейс для настройки. Конфигурационные файлы:</p>
|
||||
<ul>
|
||||
<li><code>$HOME/.config/netctl-gui.conf</code> - пользовательские настройки GUI/хелпера</li>
|
||||
@ -160,7 +160,7 @@ sudo make install
|
||||
<!-- end of config block -->
|
||||
|
||||
<!-- gui block -->
|
||||
<h2><a href="#gui" class="anchor" name="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
<p>Графический интерфейс предоставляется приложением <code>netctl-gui</code>.</p>
|
||||
|
||||
<h3><a name="screenshots" class="anchor" href="#screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
||||
|
||||
@ -15,26 +15,26 @@ links:
|
||||
- Пакет в <a href="https://aur.archlinux.org/packages/kdeplasma-applets-oblikuestrategies" title="AUR">AUR</a>
|
||||
---
|
||||
<!-- info block -->
|
||||
<h2><a href="#info" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<p>Плазмоид, написанный на <code>CPP</code> который показывает случайные карты из Brian Eno и Peter Schmidt's <a href="http://en.wikipedia.org/wiki/Oblique_strategies" title="Wiki">Oblique Strategies</a>. Это форк <a href="http://gnome-look.org/content/show.php/Oblique+Strategies?content=78405" title="gnome-look">апплета для GNOME</a> с некоторыми дополнительными фичами.</p>
|
||||
|
||||
<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<ul>
|
||||
{% for devel in page.developers %}
|
||||
<li>{{ devel }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
<h3><a href="#license" class="anchor" name="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<ul>
|
||||
<li>{{ page.license }}</li>
|
||||
</ul>
|
||||
<!-- end of info block -->
|
||||
|
||||
<!-- install block -->
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<ul>
|
||||
<li><p>Скачайте <a href="https://github.com/arcan1s/oblikuestrategies/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
|
||||
<li><p>Извлеките из него файлы и установите приложение. Для глобальной установки наберите:</p>
|
||||
@ -74,7 +74,7 @@ kbuildsycoca4 &> /dev/null
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
||||
<ul>
|
||||
<li>kdebase-workspace</li>
|
||||
@ -84,19 +84,19 @@ kbuildsycoca4 &> /dev/null
|
||||
<!-- end of install block -->
|
||||
|
||||
<!-- howto block -->
|
||||
<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<p>Откройте список виджетов Plasma и выберете <code>Oblikue strategies</code>.</p>
|
||||
<!-- end of howto block -->
|
||||
|
||||
<!-- config block -->
|
||||
<h2><a href="#config" class="anchor" name="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<p>Клик правой кнопкой по виджету.</p>
|
||||
<!-- end of config block -->
|
||||
|
||||
<!-- gui block -->
|
||||
<h2><a href="#gui" class="anchor" name="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
|
||||
<h3><a href="#screenshots" class="anchor" name="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
||||
<h3><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h3>
|
||||
<div class="thumbnails">
|
||||
{% assign scrdesc = "Виджет" %}
|
||||
{% assign scrname = "oblikuestrategies_widget" %}
|
||||
|
||||
@ -20,31 +20,31 @@ links:
|
||||
- Пакет в <a href="https://aur.archlinux.org/packages/kdeplasma-applets-pytextmonitor" title="AUR">AUR</a>
|
||||
---
|
||||
<!-- info block -->
|
||||
<h2><a href="#information" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<p>Минималистичный пламоид, написанный на <code>Python2</code>. Он выглядит, как виджеты в <a href="http://awesome.naquadah.org/" title="Домашняя страница Awesome">Awesome WM</a>. Мой плазмоид хорошо и легко настраивается и не засоряет Ваш KDE. Также данный пакет имеет дополнительный <a href="http://techbase.kde.org/Development/Tutorials/Plasma/DataEngines" title="Мануал для разработчиков">DataEngine</a>, который написан на <code>CPP</code> (старые версии были написаны на <code>Python2</code>).</p>
|
||||
|
||||
<p><b>ВНИМАНИЕ:</b> <a href="https://github.com/arcan1s/pytextmonitor/issues/14" title="Тикет">НУЖНЫ ПЕРЕВОДЧИКИ!</a></p>
|
||||
|
||||
<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<ul>
|
||||
{% for devel in page.developers %}
|
||||
<li>{{ devel }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
<h3><a href="#license" class="anchor" name="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<ul>
|
||||
<li>{{ page.license }}</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#changelog" class="anchor" name="changelog"><span class="octicon octicon-link"></span></a>Список изменений</h3>
|
||||
<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Список изменений</h3>
|
||||
<p><a href="https://github.com/arcan1s/pytextmonitor/blob/master/CHANGELOG-RU" title="GitHub">CHANGELOG-RU</a></p>
|
||||
<!-- end of info block -->
|
||||
|
||||
<!-- install block -->
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<ul>
|
||||
<li><p>Скачайте <a href="https://github.com/arcan1s/pytextmonitor/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
|
||||
<li><p>Извлеките из него файлы и установите:</p>
|
||||
@ -70,7 +70,7 @@ sudo make install
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
||||
<ul>
|
||||
<li>kdebase-workspace</li>
|
||||
@ -87,22 +87,22 @@ sudo make install
|
||||
<!-- end of install block -->
|
||||
|
||||
<!-- howto block -->
|
||||
<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<p>Откройте список виджетов Plasma и выберете <code>Py Text Monitor</code>.</p>
|
||||
|
||||
<h3><a href="#tips" class="anchor" name="tips"><span class="octicon octicon-link"></span></a>Tips & tricks</h3>
|
||||
<h3><a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks</h3>
|
||||
<p>Вы можете использовать различные цвета в полях. Просто вставьте нужный текст в html код. Смотри <a href="https://github.com/arcan1s/pytextmonitor/issues/9" title="GitHub">вопрос</a> для более подробной информации.</p>
|
||||
|
||||
<p>Нумерация элементов в полях температура, использование HDD, скорость HDD, температура HDD ссылается на порядок элементов во второй вкладке (<i>Расширенные настройки</i>). Вы должны сначала добавить требуемые элементы в нужный listWidget. И первый элемент в listWdiget будет связан c <code>$tag0</code>. Смотри <a href="https://github.com/arcan1s/pytextmonitor/issues/17" title="GitHub">вопрос</a> для более подробной информации.</p>
|
||||
<!-- end of howto block -->
|
||||
|
||||
<!-- config block -->
|
||||
<h2><a href="#config" class="anchor" name="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
|
||||
<h3><a href="#deconf" class="anchor" name="deconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine</h3>
|
||||
<h3><a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine</h3>
|
||||
<p>Вы можете отредактировать настройки DataEngine, которые хранятся в <code>/usr/share/config/extsysmon.conf</code> или <code>$HOME/.kde4/share/config/extsysmon.conf</code> в зависимости от типа установки. Раскомментируйте необходимые строчки и отредактируйте их.</p>
|
||||
|
||||
<h4><a href="#deoptions" class="anchor" name="deoptions"><span class="octicon octicon-link"></span></a>Опции DataEngine</h4>
|
||||
<h4><a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>Опции DataEngine</h4>
|
||||
<table>
|
||||
<tr>
|
||||
<th>CUSTOM</th>
|
||||
@ -146,7 +146,7 @@ sudo make install
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h3><a href="#widconf" class="anchor" name="widconf"><span class="octicon octicon-link"></span></a>Настройка виджета</h3>
|
||||
<h3><a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Настройка виджета</h3>
|
||||
<p>Для настройки внешнего вида Вы должны открыть окно настроек и установить требуемый формат. Порядок меток изменится, если Вы измените положение слайдера. В метках работают HTML теги.<br>
|
||||
<b>ЗАМЕЧАНИЕ</b> Вы не можете, например, заставить его показывать Вам <code>$cpu</code> в метка swap. <b><code>$cpu</code> будет работать только в метке cpu.</b></p>
|
||||
|
||||
@ -374,7 +374,7 @@ sudo make install
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h4><a href="#advanced" class="anchor" name="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки</h4>
|
||||
<h4><a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки</h4>
|
||||
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный.</p>
|
||||
|
||||
<p><b>Вертикальная разметка:</b> Использовать вертикальную разметку вместо горизонтальной.</p>
|
||||
@ -501,10 +501,10 @@ sudo make install
|
||||
|
||||
<p><b>Устройство AC:</b> Файл, содержащий информацию об адапторе питания. Данный файл (<code>/sys/class/power_supply/AC/online</code> по умолчанию) должен содержать <code>1</code>, если устройство подключено.</p>
|
||||
|
||||
<h4><a href="#tooltips" class="anchor" name="tooltips"><span class="octicon octicon-link"></span></a>Тултипы</h4>
|
||||
<h4><a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Тултипы</h4>
|
||||
<p>Начиная с версии 1.7.0, поля CPU, частота CPU, память, swap, сеть поддерживают графический тултип (всплывающая подсказка). Чтобы включить их, просто сделайте требуемые чекбоксы полностью чекнутыми. Число хранимых значений может быть установленно во вкладке. Цвета графиков настраиваются тоже.</p>
|
||||
|
||||
<h4><a href="#deguiconf" class="anchor" name="deguiconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine</h4>
|
||||
<h4><a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine</h4>
|
||||
<p><b>Своя команда:</b> <i><b>ЗАМЕЧАНИЕ</b> это поле может привести к "зависанию" компьютера.</i> Команды, которые будут запущены для соответствующего поля. Например, <code>wget -qO- http://ifconfig.me/ip</code> вернет внешний IP.</p>
|
||||
|
||||
<p><b>Комадна для определения рабочего стола</b> Введите команду, которая будет запущеная для desktop DataEngine. По умолчанию <code>qdbus org.kde.kwin /KWin currentDesktop</code>.</p>
|
||||
@ -560,10 +560,10 @@ sudo make install
|
||||
|
||||
<p><b>Музыкальный плеер:</b> Выберете один из поддерживаемых музыкальных плееров для соответствующего поля.</p>
|
||||
|
||||
<h3><a href="#desktoppanel" class="anchor" name="desktoppanel"><span class="octicon octicon-link"></span></a>PTM desktop panel</h3>
|
||||
<h3><a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>PTM desktop panel</h3>
|
||||
<p>Начиная с версии 1.11.0 PyTextMonitor предоставляет минималистичную панель для мониторинга за рабочими столами, написанный на <code>C++</code>. И да, он выглядит, как аналогичная панель в Awesome.</p>
|
||||
|
||||
<h4><a href="#ptmdpconf" class="anchor" name="ptmdpconf"><span class="octicon octicon-link"></span></a>Настройка PTM desktop panel</h4>
|
||||
<h4><a href="#ptmdpconf" class="anchor" id="ptmdpconf"><span class="octicon octicon-link"></span></a>Настройка PTM desktop panel</h4>
|
||||
<p><b>Включить фон:</b> Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный.</p>
|
||||
|
||||
<p><b>Вертикальная разметка:</b> Использовать вертикальную разметку вместо горизонтальной.</p>
|
||||
@ -596,9 +596,9 @@ sudo make install
|
||||
<!-- end of config block -->
|
||||
|
||||
<!-- gui block -->
|
||||
<h2><a href="#gui" class="anchor" name="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Графический интерфейс</h2>
|
||||
|
||||
<h2><a href="#screenshots" class="anchor" name="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h2>
|
||||
<h2><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Скриншоты</h2>
|
||||
<div class="thumbnails">
|
||||
{% assign scrdesc = "Виджет (кликабельно)" %}
|
||||
{% assign scrname = "pytextmonitor_widget" %}
|
||||
|
||||
@ -13,7 +13,7 @@ license: GPLv3
|
||||
links:
|
||||
---
|
||||
<!-- info block -->
|
||||
<h2><a href="#info" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<p>Демон для запуска задач в очередь вычислений. Был создан, как proof-of-concept.</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -39,23 +39,23 @@ Parameters:
|
||||
-h --help - show this help and exit
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<ul>
|
||||
{% for devel in page.developers %}
|
||||
<li>{{ devel }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
<h3><a href="#license" class="anchor" name="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<ul>
|
||||
<li>{{ page.license }}</li>
|
||||
</ul>
|
||||
<!-- end of info block -->
|
||||
|
||||
<!-- install block -->
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<ul>
|
||||
<li><p>Скачайте <a href="https://github.com/arcan1s/queued/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
|
||||
<li><p>Извлеките из него файлы и установите приложение:</p>
|
||||
@ -73,7 +73,7 @@ sudo ./install.sh
|
||||
<p>Если путь не указан, пакет будет установлен в <code>/</code>.</p></li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
||||
<ul>
|
||||
<li>Bash (включая awk, grep, sed)</li>
|
||||
@ -82,7 +82,7 @@ sudo ./install.sh
|
||||
<!-- end of install block -->
|
||||
|
||||
<!-- howto block -->
|
||||
<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<p>Если Вы хотите запустить демон, просто запустите</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -119,7 +119,7 @@ ExecStart=/usr/bin/queued
|
||||
ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
|
||||
{% endhighlight %}
|
||||
|
||||
<h3><a href="#adding" class="anchor" name="adding"><span class="octicon octicon-link"></span></a>Добавление задачи</h3>
|
||||
<h3><a href="#adding" class="anchor" id="adding"><span class="octicon octicon-link"></span></a>Добавление задачи</h3>
|
||||
<ol>
|
||||
<li>Создайте скрипт с командой (например, с именем <code>script.sh</code>).</li>
|
||||
<li>Создайте файл с приоритетом (<code>script.sh.pr</code>) для данной задачи, если это необходимо.</li>
|
||||
@ -128,7 +128,7 @@ ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
|
||||
</ol>
|
||||
<p>Также Вы можете воспользоваться <code>add_queued</code>.</p>
|
||||
|
||||
<h2><a href="#configuration" class="anchor" name="configuration"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<h2><a href="#configuration" class="anchor" id="configuration"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<p>Все настройки хранятся в <code>/etc/queued.conf</code>. После редактирования, Вы должны перезапустить демон</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -137,7 +137,7 @@ systemctl restart queued
|
||||
<!-- end of howto block -->
|
||||
|
||||
<!-- config block -->
|
||||
<h3><a href="#options" class="anchor" name="options"><span class="octicon octicon-link"></span></a>Опции</h3>
|
||||
<h3><a href="#options" class="anchor" id="options"><span class="octicon octicon-link"></span></a>Опции</h3>
|
||||
<table>
|
||||
<tr>
|
||||
<th>WORKDIR</th>
|
||||
|
||||
@ -13,27 +13,27 @@ license: LGPLv3
|
||||
links:
|
||||
---
|
||||
<!-- info block -->
|
||||
<h2><a href="#info" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<h2><a href="#info" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Информация</h2>
|
||||
<p>Приложение/библиотека, написанное на Qt, которое позволяет пользователям отправлять багрепорт для проектов, расположенных на GitHub. Оно может работать как через <a href="https://github.com" title="GitHub">GitHub</a>, так и через <a href="https://gitreports.com" title="GitReports">GitReports</a>. Работает нормально, однако данное приложение было создано as proof-of-concept.</p>
|
||||
|
||||
<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
|
||||
<ul>
|
||||
{% for devel in page.developers %}
|
||||
<li>{{ devel }}</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
<h3><a href="#license" class="anchor" name="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>Лицензия</h3>
|
||||
<ul>
|
||||
<li>{{ page.license }}</li>
|
||||
</ul>
|
||||
<!-- end of info block -->
|
||||
|
||||
<!-- install block -->
|
||||
<h2><a href="#install" class="anchor" name="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Установка</h2>
|
||||
|
||||
<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h4><a href="#singleapp" class="anchor" name="singleapp"><span class="octicon octicon-link"></span></a>Сборка, как отдельное приложение</h4>
|
||||
<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция</h3>
|
||||
<h4><a href="#singleapp" class="anchor" id="singleapp"><span class="octicon octicon-link"></span></a>Сборка, как отдельное приложение</h4>
|
||||
<ul>
|
||||
<li>Скачайте <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
||||
<li>Извлеките из него файлы и настройте под себя.</li>
|
||||
@ -50,7 +50,7 @@ sudo make install
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h4><a href="#aslibrary" class="anchor" name="aslibrary"><span class="octicon octicon-link"></span></a>Сборка, как библиотека в проекте</h4>
|
||||
<h4><a href="#aslibrary" class="anchor" id="aslibrary"><span class="octicon octicon-link"></span></a>Сборка, как библиотека в проекте</h4>
|
||||
<ul>
|
||||
<li>Скачайте <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
|
||||
<li>Извлеките из него файлы и настройте под себя.</li>
|
||||
@ -74,7 +74,7 @@ reportWindow->showWindow();
|
||||
<li>Слинкуйте Ваше приложение с библиотекой.</li>
|
||||
</ul>
|
||||
|
||||
<h4><a href="#cmakeflags" class="anchor" name="cmakeflags"><span class="octicon octicon-link"></span></a>Доступные флаги cmake</h4>
|
||||
<h4><a href="#cmakeflags" class="anchor" id="cmakeflags"><span class="octicon octicon-link"></span></a>Доступные флаги cmake</h4>
|
||||
<ul>
|
||||
<li><code>-DBUILD_AS_LIBRARY=0</code> - собирать отдельное приложение, а не библиотеку.</li>
|
||||
<li><code>-DBUILD_DOCS=1</code> - собирать документацию для разработчиков.</li>
|
||||
@ -85,7 +85,7 @@ reportWindow->showWindow();
|
||||
<li><code>-DUSE_QT5=0</code> - использовать Qt4 вместо Qt5.</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости</h3>
|
||||
<p>Все было протестировано на последних версиях зависимостей.</p>
|
||||
<ul>
|
||||
<li>qt5-base <i>(если используется Qt5)</i> <b>или</b> qt4 <i>(если используется Qt4)</i></li>
|
||||
@ -98,8 +98,8 @@ reportWindow->showWindow();
|
||||
<!-- end of install block -->
|
||||
|
||||
<!-- howto block -->
|
||||
<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h3><a href="#github" class="anchor" name="github"><span class="octicon octicon-link"></span></a>Модуль GitHub</h3>
|
||||
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>Использование</h2>
|
||||
<h3><a href="#github" class="anchor" id="github"><span class="octicon octicon-link"></span></a>Модуль GitHub</h3>
|
||||
<p>Данный модуль создает тикет, используя <a href="https://developer.github.com/v3/issues/" title="Документация">GitHub API</a>. Данный модуль требует авторизации пользователя. Типичный POST запрос выглядит так:</p>
|
||||
|
||||
{% highlight bash %}
|
||||
@ -123,16 +123,16 @@ curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"So
|
||||
|
||||
<p>Данный модуль требует наличия в системе <code>QtNetwork</code>.</p>
|
||||
|
||||
<h3><a href="#gitreports" class="anchor" name="gitreports"><span class="octicon octicon-link"></span></a>Модуль GitReports</h3>
|
||||
<h3><a href="#gitreports" class="anchor" id="gitreports"><span class="octicon octicon-link"></span></a>Модуль GitReports</h3>
|
||||
<p>Данный модуль создает тикет, используя возможности <a href="https://gitreports.com/about" title="GitReports">GitReports</a>. Пожалуйста, посетите <a href="https://gitreports.com/" title="GitReports">данную страницу</a> и настройте под Ваши репозитории.</p>
|
||||
|
||||
<p>Для того, чтобы отключить данный модуль, используйте <code>-DENABLE_GITREPORT=0</code> флаг cmake. Данный модуль требует наличия в системе <code>QtNetwork</code> и <code>QtWebKit</code>.</p>
|
||||
<!-- end of howto block -->
|
||||
|
||||
<!-- config block -->
|
||||
<h2><a href="#config" class="anchor" name="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Настройка</h2>
|
||||
<p>Для настройки перед компиляцией отредактируйте хидер <code>src/config.h</code>. Также Вы можете подгрузить параметры автоматически, используя массив <code>params</code> (необходимые ключи такие же, как и для хидера).</p>
|
||||
<h3><a href="#mainconfig" class="anchor" name="mainconfig"><span class="octicon octicon-link"></span></a>Основные настройки</h3>
|
||||
<h3><a href="#mainconfig" class="anchor" id="mainconfig"><span class="octicon octicon-link"></span></a>Основные настройки</h3>
|
||||
<ul>
|
||||
<li><code>OWNER</code> - владелец репозитория.</li>
|
||||
<li><code>PROJECT</code> - имя проекта.</li>
|
||||
@ -143,13 +143,13 @@ curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"So
|
||||
<li><code>TAG_MILESTONE</code> - установить данную веху тикету. Может быть использовано только в модуле GitHub. Данный тег будет работать, только если пользователь имеет права на запись. Если будет пустым, будет проигнорировано.</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#githubconfig" class="anchor" name="githubconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitHub</h3>
|
||||
<h3><a href="#githubconfig" class="anchor" id="githubconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitHub</h3>
|
||||
<ul>
|
||||
<li><code>GITHUB_COMBOBOX</code> - текст модуля в ComboBox.</li>
|
||||
<li><code>ISSUES_URL</code> - URL, в большинстве случаев, не редактируйте его. По умолчанию <code>https://api.github.com/repos/$OWNER/$PROJECT/issues</code>. Доступные теги <code>$PROJECT</code>, <code>$OWNER</code>.</li>
|
||||
</ul>
|
||||
|
||||
<h3><a href="#gitreportsconfig" class="anchor" name="gitreportsconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitReports</h3>
|
||||
<h3><a href="#gitreportsconfig" class="anchor" id="gitreportsconfig"><span class="octicon octicon-link"></span></a>Настройки модуля GitReports</h3>
|
||||
<ul>
|
||||
<li><code>CAPTCHA_URL</code> - URL капчи, в большинстве случаев, не редактируйте его. По умолчанию <code>https://gitreports.com/simple_captcha?code=</code>.</li>
|
||||
<li><code>GITREPORT_COMBOBOX</code> - текст модуля в ComboBox.</li>
|
||||
|
||||
Reference in New Issue
Block a user