add reportabug pages and fix typo

2025-04-24 15:27:17 +00:00 · 2014-07-30 23:06:56 +04:00 · 2014-07-30 23:06:56 +04:00 · a7693615d0
commit a7693615d0
parent c1b3a436ad
14 changed files with 197 additions and 25 deletions
--- a/projects/git-etc.html
+++ b/projects/git-etc.html
@ -6,7 +6,7 @@ short: git-etc
 hasgui: true
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPLv3
 links:
    - Archlinux <a href="https://aur.archlinux.org/packages/git-etc" title="AUR">AUR package</a>
--- a/projects/index.html
+++ b/projects/index.html
@ -94,6 +94,13 @@ groups:
                - <a href="https://github.com/arcan1s/netctlplasmoid" title="GitHub">GitHub repo</a>
                - Page on <a href="http://kde-apps.org/content/show.php?content=164490" title="kde-apps">kde-apps.org</a>
                - <a href="https://aur.archlinux.org/packages/netctl-gui" title="AUR">Archlinux AUR package</a>
+          - title: Report a Bug
+            short: reportabug
+            description: Qt application/library which allows users to create an issue for projects which are hosted on GitHub. It may work over <a href="https://github.com" title="GitHub">GitHub</a> or <a href="https://gitreports.com/" title="GitReports">GitReport</a>.
+            links:
+                - <a href="/projects/reportabug" title="Homepage">Homepage</a>
+                - <a href="https://github.com/arcan1s/reportabug" title="GitHub">GitHub repo</a>
+
 ---
  <body>
    <div class="wrapper">
--- a/projects/netctl-gui.html
+++ b/projects/netctl-gui.html
@ -6,7 +6,7 @@ short: netctl-gui
 hasgui: true
 hasdocs: true
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPLv3
 links:
    - Page on <a href="http://linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
--- a/projects/oblikuestrategies.html
+++ b/projects/oblikuestrategies.html
@ -6,7 +6,7 @@ short: oblikuestrategies
 hasgui: true
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPL
 links:
    - Page on <a href="http://kde-look.org/content/show.php/oblikue-strategies?content=160503" title="kde-look">kde-look.org</a>
--- a/projects/pytextmonitor.html
+++ b/projects/pytextmonitor.html
@ -6,7 +6,7 @@ short: pytextmonitor
 hasgui: true
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
    - Ernesto Avilés Vzqz (Spanish translation)
    - Mermouy (French translation)
    - underr (Brazillian Portuguese translation)
--- a/projects/queued.html
+++ b/projects/queued.html
@ -6,7 +6,7 @@ short: queued
 hasgui: false
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPLv3
 links:
 ---
--- a/projects/reportabug.html
+++ b/projects/reportabug.html
@ -0,0 +1,159 @@
+---
+hastr: true
+layout: project
+title: Report a Bug
+short: reportabug
+hasgui: false
+hasdocs: true
+developers:
+    - Evgeniy Alekseev
+license: LGPLv3
+links:
+---
+<!-- info block -->
+<h2><a href="#info" class="anchor" name="info"><span class="octicon octicon-link"></span></a>Information</h2>
+<p>Qt application/library which allows users to create an issue for projects which are hosted on GitHub. It may work over <a href="https://github.com" title="GitHub">GitHub</a> or <a href="https://gitreports.com/" title="GitReports">GitReport</a>.</p>
+
+<h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</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>License</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>Installation</h2>
+
+<h3><a href="#instruction" class="anchor" name="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
+<h4><a href="#singleapp" class="anchor" name="singleapp"><span class="octicon octicon-link"></span></a>Build as a single application</h4>
+<ul>
+  <li>Download the actual source <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">tarball</a>.</li>
+  <li>Extract it and set up your configuration.</li>
+  <li>Install the application:
+
+{% highlight bash %}
+cd /path/to/extracted/archive
+mkdir build && cd build
+cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release -DBUILD_AS_LIBRARY:BOOL=0 ../
+make
+sudo make install
+{% endhighlight %}
+
+  </li>
+</ul>
+
+<h4><a href="#aslibrary" class="anchor" name="aslibrary"><span class="octicon octicon-link"></span></a>Build as a library in your project</h4>
+<ul>
+  <li>Download the actual source <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">tarball</a>.</li>
+  <li>Extract it and set up your configuration.</li>
+  <li>include it into your project. For example if you use <code>cmake</code>:
+
+{% highlight cmake %}
+add_subdirectory (reportabug)
+{% endhighlight %}
+
+  </li>
+  <li>Declare class in you sources. For example:
+
+{% highlight cpp %}
+Reportabug *reportWindow = new Reportabug(this, false);
+reportWindow->showWindow();
+{% endhighlight %}
+
+  </li>
+  <li>Link your application with this library.</li>
+</ul>
+
+<h4><a href="#cmakeflags" class="anchor" name="cmakeflags"><span class="octicon octicon-link"></span></a>Available cmake flags:</h4>
+<ul>
+  <li><code>-DBUILD_AS_LIBRARY:BOOL=0</code> - build the application but not a shared library.</li>
+  <li><code>-DBUILD_DOCS:BOOL=1</code> - build developer documentation.</li>
+  <li><code>-DENABLE_GITHUB=0</code> - disable GitHub module.</li>
+  <li><code>-DENABLE_GITREPORT=0</code> - disable GitReport module.</li>
+  <li><code>-DOWN_GITHUB_TOKEN=STRING</code> - use STRING as own GitHub token.</li>
+  <li><code>-DUSE_QT5:BOOL=0</code> - use Qt4 instead of Qt5.</li>
+</ul>
+
+<h3><a href="#dependencies" class="anchor" name="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
+<p>I want note that all were tested on latest version of dependencies.</p>
+<ul>
+  <li>qt5-base <i>(if Qt5 is used)</i> <b>or</b> qt4 <i>(if Qt4 is used)</i></li>
+  <li>automoc4 <i>(make)</i></li>
+  <li>cmake <i>(make)</i></li>
+  <li>doxygen <i>(make, documentation)</i></li>
+  <li>qt5-network (if Qt5 is used) <i>(optional, required by GitHub module)</i></li>
+  <li>qt5-webkit (if Qt5 is used) <b>or</b> qtwebkit (if Qt4 is used) <i>(optional, required by GitReports module)</i></li>
+</ul>
+<!-- end of install block -->
+
+<!-- howto block -->
+<h2><a href="#howto" class="anchor" name="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
+<h3><a href="#github" class="anchor" name="github"><span class="octicon octicon-link"></span></a>GitHub module</h3>
+
+<p>This module creates an issue over GitHub. <a href="https://developer.github.com/v3/issues/" title="Documentation">GitHub API</a> is used for creating issue. User should type own username and password. The typical POST request is:</p>
+
+{% highlight bash %}
+curl -X POST -u user:pass -d '{"title":"A new bug","body":"Some error occurs"}' \
+     https://api.github.com/repos/owner/repo/issues
+{% endhighlight %}
+
+<p>To disable this module use <code>-DENABLE_GITHUB=0</code> cmake flag.</p>
+
+<p>This module may send request using developer's token too. Please visit <a href="https://github.com/settings/applications" title="Settings">this page</a> and generate a new one. Needed scopes are <code>public_repo</code> (or <code>repo</code> if you will use it for a private repository).<br>
+<b>Please keep in mind that passing the token in the clear, you may discredit your account.</b></p>
+
+<p>The typical POST request is:</p>
+
+{% highlight bash %}
+curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"Some error occurs"}' \
+     https://api.github.com/repos/owner/repo/issues
+{% endhighlight %}
+
+<p>To enable this module set up your token using <code>-DOWN_GITHUB_TOKEN=0</code> cmake flag.</p>
+
+<p>This module requires <code>QtNetwork</code> module.</p>
+
+<h3><a href="#gitreports" class="anchor" name="gitreports"><span class="octicon octicon-link"></span></a>GitReports module</h3>
+<p>This module creates issue over <a href="https://gitreports.com/about" title="GitReports">GitReports</a>. Please visit <a href="https://gitreports.com/" title="GitReports">this page</a> and set up it for your repository.</p>
+
+<p>To disable this module use <code>-DENABLE_GITREPORT=0</code> cmake flag. This module requires <code>QtWebKit</code> module.</p>
+<!-- end of howto block -->
+
+<!-- config block -->
+<h2><a href="#config" class="anchor" name="config"><span class="octicon octicon-link"></span></a>Configuration</h2>
+<p>For the developer configuration please use <code>config.h.in</code> header.</p>
+<h3><a href="#mainconfig" class="anchor" name="mainconfig"><span class="octicon octicon-link"></span></a>Main configuration</h3>
+<ul>
+  <li><code>OWNER</code> - the owner of the source repository.</li>
+  <li><code>PROJECT</code> - the project name.</li>
+  <li><code>TAG_BODY</code> - default body of an issue. It may be used for both modules.</li>
+  <li><code>TAG_TITLE</code> - default title of an issue. It may be used only for GitHub module.</li>
+  <li><code>TAG_ASSIGNEE</code> - assign an issue to this account. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.</li>
+  <li><code>TAG_LABELS</code> - set these labels to an issue. Labels should be comma separated. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.</li>
+  <li><code>TAG_MILESTONE</code> - set this milestone to an issue. It may be used only for GitHub module. This tag will work only if user has push access. If it will be empty, it will be ignored.</li>
+</ul>
+
+<h3><a href="#githubconfig" class="anchor" name="githubconfig"><span class="octicon octicon-link"></span></a>GitHub module settings</h3>
+<ul>
+  <li><code>GITHUB_COMBOBOX</code> - text of this module into comboBox.</li>
+  <li><code>ISSUES_URL</code> - issues url, in the most cases do not touch it. Default is <code>https://api.github.com/repos/$OWNER/$PROJECT/issues</code>. Available tags here are <code>$PROJECT</code>, <code>$OWNER</code>.</li>
+</ul>
+
+<h3><a href="#gitreportsconfig" class="anchor" name="gitreportsconfig"><span class="octicon octicon-link"></span></a>GitReports module settings</h3>
+<ul>
+  <li><code>CAPTCHA_KEY</code> - captcha key. It may be found in the source of the <code>PUBLIC_URL</code> page. Default is <code>7f6ef90bce7389088a52c5c9101aad206b21b56d</code>.</li>
+  <li><code>CAPTCHA_TEXT</code> - captcha text. It may be found in the source of the <code>PUBLIC_URL</code> page. Default is <code>QJNZXY</code>.</li>
+  <li><code>CAPTCHA_TIME</code> - captcha time. It may be found in the source of the <code>PUBLIC_URL</code> page. Default is <code>1406531273</code>.</li>
+  <li><code>GITREPORT_COMBOBOX</code> - text of this module into comboBox.</li>
+  <li><code>PUBLIC_URL</code> - issues url, in the most cases do not touch it. Default is <code>https://gitreports.com/issue/$OWNER/$PROJECT</code>. Available tags here are <code>$PROJECT</code>, <code>$OWNER</code>.</li>
+</ul>
+<!-- end of config block -->
+
+<!-- gui block -->
+<!-- end of gui block -->
--- a/ru/projects/git-etc.html
+++ b/ru/projects/git-etc.html
@ -7,7 +7,7 @@ short: git-etc
 hasgui: true
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPLv3
 links:
    - Пакет в <a href="https://aur.archlinux.org/packages/git-etc" title="AUR">AUR</a>
--- a/ru/projects/index.html
+++ b/ru/projects/index.html
@ -95,6 +95,12 @@ groups:
                - <a href="https://github.com/arcan1s/netctl-gui" title="GitHub">Репозиторий на GitHub</a>
                - <a href="http://kde-apps.org/content/show.php?content=164490" title="kde-apps">Страница на kde-apps.org</a>
                - <a href="https://aur.archlinux.org/packages/netctl-gui" title="AUR">Пакет в AUR</a>
+          - title: Report a Bug
+            short: reportabug
+            description: Приложение/библиотека, написанное на Qt, которое позволяет пользователям отправлять багрепорт для проектов, расположенных на GitHub. Оно может работать как через <a href="https://github.com" title="GitHub">GitHub</a>, так и через <a href="https://gitreports.com" title="GitReports">GitReports</a>.
+            links:
+                - <a href="/ru/projects/reportabug" title="Homepage">Домашняя страница</a>
+                - <a href="https://github.com/arcan1s/reportabug" title="GitHub">Репозиторий на GitHub</a>
 ---
  <body>
    <div class="wrapper">
--- a/ru/projects/netctl-gui.html
+++ b/ru/projects/netctl-gui.html
@ -7,7 +7,7 @@ short: netctl-gui
 hasgui: true
 hasdocs: true
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPLv3
 links:
    - Страница на <a href="http://linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml" title="Softpedia">Softpedia</a>
--- a/ru/projects/oblikuestrategies.html
+++ b/ru/projects/oblikuestrategies.html
@ -7,7 +7,7 @@ short: oblikuestrategies
 hasgui: true
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPL
 links:
    - Страница на <a href="http://kde-look.org/content/show.php/oblikue-strategies?content=160503" title="kde-look">kde-look.org</a>
--- a/ru/projects/pytextmonitor.html
+++ b/ru/projects/pytextmonitor.html
@ -7,7 +7,7 @@ short: pytextmonitor
 hasgui: true
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
    - Ernesto Avilés Vzqz (перевод на испанский)
    - Mermouy (перевод на французский)
    - underr (перевод на бразильский португальский)
--- a/ru/projects/queued.html
+++ b/ru/projects/queued.html
@ -7,7 +7,7 @@ short: queued
 hasgui: false
 hasdocs: false
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: GPLv3
 links:
 ---
--- a/ru/projects/reportabug.html
+++ b/ru/projects/reportabug.html
@ -7,13 +7,13 @@ short: reportabug
 hasgui: false
 hasdocs: true
 developers:
-    - Evgeniy Alelseev
+    - Evgeniy Alekseev
 license: LGPLv3
 links:
 ---
 <!-- info block -->
 <h2><a href="#info" class="anchor" name="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>.</p>
+<p>Приложение/библиотека, написанное на Qt, которое позволяет пользователям отправлять багрепорт для проектов, расположенных на GitHub. Оно может работать как через <a href="https://github.com" title="GitHub">GitHub</a>, так и через <a href="https://gitreports.com" title="GitReports">GitReports</a>.</p>

 <h3><a href="#devel" class="anchor" name="devel"><span class="octicon octicon-link"></span></a>Разработчики</h3>
 <ul>
@ -32,11 +32,11 @@ links:
 <h2><a href="#install" class="anchor" name="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>
+<h4><a href="#singleapp" class="anchor" name="singleapp"><span class="octicon octicon-link"></span></a>Сборка, как отдельное приложение</h4>
 <ul>
-  <li><p>Скачайте <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
-  <li><p>Извлеките из него файлы и настройте под себя.</p></li>
-  <li><p>Установите приложение:</p>
+  <li>Скачайте <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
+  <li>Извлеките из него файлы и настройте под себя.</li>
+  <li>Установите приложение:

 {% highlight bash %}
 cd /path/to/extracted/archive
@ -49,18 +49,18 @@ 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" name="aslibrary"><span class="octicon octicon-link"></span></a>Сборка, как библиотека в проекте</h4>
 <ul>
-  <li><p>Скачайте <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</p></li>
-  <li><p>Извлеките из него файлы и настройте под себя.</p>
-  <li><p>Включите библиотеку в Ваш проект. Например, если Вы используете <code>cmake</code>:</p>
+  <li>Скачайте <a href="https://github.com/arcan1s/reportabug/releases" title="GitHub">архив</a> с актуальной версией исходных файлов.</li>
+  <li>Извлеките из него файлы и настройте под себя.</li>
+  <li>Включите библиотеку в Ваш проект. Например, если Вы используете <code>cmake</code>:

 {% highlight cmake %}
 add_subdirectory (reportabug)
 {% endhighlight %}

  </li>
-  <li><p>Объявите класс в Вашем приложении, например:</p>
+  <li>Объявите класс в Вашем приложении, например:

 {% highlight cpp %}
 Reportabug *reportWindow = new Reportabug(this, false);
@ -71,7 +71,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" name="cmakeflags"><span class="octicon octicon-link"></span></a>Доступные флаги cmake</h4>
 <ul>
  <li><code>-DBUILD_AS_LIBRARY:BOOL=0</code> - собирать отдельное приложение, а не библиотеку.</li>
  <li><code>-DBUILD_DOCS:BOOL=1</code> - собирать документацию для разработчиков.</li>
@ -115,14 +115,14 @@ curl -X POST -H "Authorization: token token" -d '{"title":"A new bug","body":"So
     https://api.github.com/repos/owner/repo/issues
 {% endhighlight %}

-<p>Для того, чтобы включить данный модуль, используйте <code>--DOWN_GITHUB_TOKEN=STRING</code> флаг cmake.</p>
+<p>Для того, чтобы включить данный модуль, используйте <code>-DOWN_GITHUB_TOKEN=STRING</code> флаг cmake.</p>

-<p>Данный модуль требует наличия в системе qt5-network.</p>
+<p>Данный модуль требует наличия в системе <code>QtNetwork</code>.</p>

 <h3><a href="#gitreports" class="anchor" name="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. Данный модуль требует наличия в системе qt5-webkit.</p>
+<p>Для того, чтобы отключить данный модуль, используйте <code>-DENABLE_GITREPORT=0</code> флаг cmake. Данный модуль требует наличия в системе <code>QtWebKit</code>.</p>
 <!-- end of howto block -->

 <!-- config block -->