>Zina: /* Тема Bootstrap3 */

2023-08-08T08:37:32Z

Тема Bootstrap3

Нова сторінка

Хранилище доступов к проектам, над которыми работает студия.

https://info.zina.com.ua

Движок - https://www.dokuwiki.org/

На Synology ЧПУ работает на Apache 2.2 и не работает на Apache 2.4.

== Права пользователей ==

Создание нового пользователя: '''Управление''' → '''[https://info.zina.company/info?do=admin&page=usermanager Управление пользователями]'''

Наши группы:

* <code>@ALL</code> — неавторизованные пользователи, нет доступа ни к чему
* <code>@user</code> — зарегистрированный пользователь, доступ на чтение к корневому <code>info</code>, к <code>snippets:</code> и на редактирование к <code>playground:</code>. Можно [https://info.zina.company/info?do=admin&page=acl&ns=dev руками назначить] доступ на чтение к определенной странице
* <code>@adm</code> — администраторы, создание и редактирование <code>adm:</code> — главные доступы к серверам
* <code>@dev</code> — разработчики, создание и редактирование <code>dev:</code>
* <code>@seo</code> — SEO-специалисты, создание и редактирование <code>seo:</code>

Новым пользователям при создании автоматически назначается группа <code>@user</code>. Если при создании пользователя прописывается руками одна из специализированных групп — <code>@dev</code>, <code>@seo</code>, <code>@adm</code>, то нужно проследить, чтобы группа <code>@user</code> тоже была добавлена, т.е. указать группы через запятую: <code>@user,@dev</code>

Добавление новой группы: '''Управление''' → '''[https://info.zina.company/info?do=admin&page=acl Управление списками контроля доступа]'''

[[Файл:DokuWiki-add-group.png]]

<div class="note">
Устарело
* <code>@trainee</code> — стажеры, нет доступа ни к чему, но можно [https://info.zina.company/info?do=admin&page=acl&ns=dev руками назначить] доступ на чтение к определенной странице

=== Active Directory (сейчас не используется) ===

У нас может быть 2 режима авторизации:

* <code>authplain</code> — обычный режим (по умолчанию)
* <code>authad</code> — авторизация через домен Active Directory

Из соображений безопасности режим авторизации меняется не через веб-интерфейс, а в файле <code>conf\local.protected.php</code> в строке:

<source lang="php">
$conf['authtype'] = 'authplain';
</source>

Если Active Directory поломается, то авторизоваться можно, переключив в файле <code>local.protected.php</code> эту строку.

В <code>local.protected.php</code> нужно добавить соответствие групп DokuWiki (слева) группам в Active Directory (справа):

<source lang="bash">
$conf['superuser'] = '@DokuWiki_Admins';
$conf['dev_admins'] = '@Dev_Admins';
$conf['manager'] = '@Project_Managers';
$conf['developers'] = '@Developers';
$conf['seo'] = '@SEO';
$conf['trainee'] = '@Trainee';
$conf['crm'] = '@CRM';
</source>
</div>

== Авто-заголовок H1 ==

У страниц с доступами к сайтам имя файла уже содержит имя домена. Настроим автоматическое отображение его вместо заголовка H1.

=== Тема Bootstrap3 ===

В шаблон <code>lib/tpl/bootstrap3/main.php</code> районе строки 130, после <code><nowiki>echo '<div class="dw-content">';</nowiki></code> добавить:

<source lang="php">
echo '<div class="dw-content">';

// Авто-заголовок H1
$namespaces = array('dev','seo','adm');
if (in_array($INFO['namespace'], $namespaces)) {
$page_title = strtr(noNS($ID),'_',' ');
if ($page_title != 'info') {
echo '<h1 style="margin-top: 0;">'.$page_title.'</h1>';
}
}

echo $content;
</source>

В шаблон <code>lib/tpl/bootstrap3/navbar.php</code> районе строки 71, после <code><nowiki><div class="navbar-right" id="dw__navbar_items"></nowiki></code> добавить:

<source lang="html">
<div class="navbar-right" id="dw__navbar_items">



<ul class="nav navbar-nav">
<li><a target="_blank" style="padding-top: 11px; padding-bottom: 8px; line-height: 16px; font-size: 13px;" href="https://www.webfx.com/tools/new-password-generator/show.php?length=8&lowercase=1&uppercase=1&numbers=1&type=ordinary">Password<br>Secure</a></li>
<li><a target="_blank" style="padding-top: 11px; padding-bottom: 8px; line-height: 16px; font-size: 13px;" href="https://www.webfx.com/tools/new-password-generator/show.php?length=8&digits=2&type=easy-to-remember">Password<br>Mnemonic</a></li>
</ul>
</source>

<div class="note">

=== Тема Mikio ===

В шаблон <code>lib/tpl/mikio/mikio.php</code> в районе 1412 строки добавить:

<source lang="php">
public function includeHero(bool $print = true)
{
// 1) Чтобы можно было использовать $INFO и $ID:
global $INFO, $ID;

$html = '';
// ...

$html .= '<h1 class="mikio-hero-title">';

// Авто-заголовок H1
$namespaces = array('dev','seo','adm');
if (in_array($INFO['namespace'], $namespaces)) {
$page_title = strtr(noNS($ID),'_',' ');
if ($page_title == 'info') {
$html .= '<span style="text-transform: uppercase;">'.$INFO['namespace'].'</span>';
} else {
$html .= $page_title;
}
} else {
$html .= $this->parsePageTitle(); // No idea why this requires a blank space afterwards to work?
}

$html .= '</h1>';
</source>
</div>

== Toolbar ==

Чтобы сократить количество спецсимволов только до необходимых, используем плагин [https://www.dokuwiki.org/plugin:charpicker charpicker].

Настройка:

* plugin»charpicker»chars: <code>→,↑,←,↓,•,✔,«,»,‹,›,—,…,©</code>
* plugin»charpicker»del_chars: пусто
* plugin»charpicker»del_all: [✔]

<div class="note">
Альтернативный вариант: в файле <code>\\nas\web\dokuwiki\inc\toolbar.php</code> в блоке <code>'title' => $lang['qb_chars'],</code>:

'list' => explode(' ','→ ↑ ← ↓ • ✔ « » ‹ › — … ©'),

После сохранения нужно или сохранить настройки, или выполнить <code>touch conf/local.php</code>
</div>
<div class="note">

== Устарело ==

=== Бэкап ===

1) Зайти по SSH:

ssh -p851 zina@37.53.93.49
cd /home/zina/web/info.zina.com.ua/

2) Бэкап файлов:

zip -r info-zd_`date +%Y-%m-%d_%H-%M`_pages.zip public_html/data/pages
zip -r info-zd_`date +%Y-%m-%d_%H-%M`_full.zip public_html

3) Скопировать на NAS (пароль <code>rsync</code> здесь: https://info.zina.com.ua/adm/nas#rsync):

rsync -av --progress /home/zina/web/info.zina.com.ua/info-zd_`date +%Y-%m-%d`* rsync@192.168.1.102::backup/info/

=== Верхняя часть info страниц ===

Чтобы сделать верхнюю часть типичных info страниц более компактной и информативной, сделаны изменения в файле темы Bootstrap 3:

\\nas\web\dokuwiki\lib\tpl\bootstrap3\main.php

примерно со строки 94:

<source lang="php">
<?php

// Page icons (print, email, share link, etc.)
// require_once(template('tpl/page-icons.php'));

tpl_flush(); /* flush the output buffer */

// Page-Header DokuWiki page
tpl_includeFile('pageheader.html');

// Page-Header DokuWiki page
if ($ACT == 'show') $TEMPLATE->includePage('pageheader');

// render the content into buffer for later use
ob_start();
tpl_content(false);

$content = ob_get_clean();
$toc = $TEMPLATE->getTOC(true);
$content_classes = array();

if ($toc) echo '<div class="dw-toc hidden-print">' . $toc . '</div>';

if ($TEMPLATE->getConf('tocCollapsed')) $content_classes[] = 'dw-toc-closed';

//Starred
if (strpos($_SERVER['REQUEST_URI'], '/info') === false) {
$starred = plugin_load('action','starred');
if ($starred) $starred->tpl_starred();
// авто-заголовок H1
$namespaces = array('dev','seo','adm');
if (in_array($INFO['namespace'], $namespaces)) {
echo '<h1 style="margin-top: 0;">'.strtr(noNS($ID),'_',' ').'</h1>';
}
}

echo '<div class="dw-content-page '. implode(' ', $content_classes) .'">';

echo '';
</source>

Дальше без изменений.

=== Starred Plugin ===

https://www.dokuwiki.org/plugin:starred

Позволяет звездочкой делать закладки на страницы.

Помимо самого плагина и требуемого плагина https://www.dokuwiki.org/plugin:sqlite добавлен код в файл шаблона <code>lib\tpl\bootstrap3\main.php</code> (со строки 96 ):

<source lang="php">//Starred
if (strpos($_SERVER['REQUEST_URI'], '/info') === false) {
$starred = plugin_load('action','starred');
if ($starred) $starred->tpl_starred();
}
</source>

=== Патчи ===

'''lib\plugins\favoris\action.php'''

строка 37:

- // function register(&$contr) {
+ function register(Doku_Event_Handler $contr) {

'''lib\plugins\favoris\syntax.php'''

строка 42:

- // function handle($match, $state, $pos, &$handler) {
+ function handle($match, $state, $pos, Doku_Handler $handler) {

строка 47:

- // function render($mode, &$renderer, $data) {
+ function render($mode, Doku_Renderer $renderer, $data) {

=== Доступ через сетевую папку ===

Папка с текстовыми файлами страниц <code>/volume1/web/dokuwiki/data/pages</code> смонтирована (типа сделана ссылка) в шаред папку <code>/volume1/Info/pages</code>, которая доступна как <code>\\nas\info\pages</code>.

Можно прямо там редактировать файлы страниц DokuWiki, заходя по сети обычным файловым менеджером.
<br>Через веб-интерфейс https://nas.zina.com.ua:5001/ почему-то не работает — не сохраняются изменения.

Временное монтирование, до перезагрузки:

<source lang="bash">sudo mount --bind /volume1/web/dokuwiki/data/pages /volume1/Info/pages</source>

Постоянное монтирование:

Control Panel — Task Scheduler — Create — Triggered Task — Task Settings — Run command:

<source lang="bash">sudo mount --bind /volume1/web/dokuwiki/data/pages /volume1/Info/pages</source>

=== Установка на Nginx ===

Не доделано — нет настройки ЧПУ, на проде используется дефаултный <code>.htaccess</code> для Apache.

Действовать по инструкции:

* https://www.dokuwiki.org/install
* https://wiki.zina.company/books/environment/page/nginx

На форуме говорят, что внутри архива права на файлы и директории корректные, менять не стоит.

Если возникает ошибка <code>DokuWiki Setup Error The datadir ('pages') at ./data/pages is not found, isn't accessible or writable</code>:

cd /var/www/dokuwiki.test
chown -R www-data:www-data ./

</div>

== Ссылки ==

* [https://www.maxreform.ru/soft/dokuwiki/setup/users Настройка пользователей DokuWiki]
* [http://xlench.bget.ru/doku.php/wiki/test/misc Разные плагины [Love Soft]]

Info.ZD - Історія редагувань

>Zina: /* Тема Bootstrap3 */