Инструменты пользователя

Инструменты сайта


dokuwiki

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

dokuwiki [2020/06/13 13:45] (текущий)
Строка 1: Строка 1:
 +====== DokuWiki ======
 +
 +~~Title: DokuWiki SEO оптимизация, настройка и использование ~~
 +{{htmlmetatags>
 +metatag-keywords=(Настройка DokuWiki) 
 +metatag-description=(Тонкая настройка DokuWiki для SEO продвижения, robots.txt описание плагинов. Подключение Google Tag Manager и рекламы AdSense. 4 SEO плагина для DokuWiki.)
 +}}
 +
 +{{ ::dokuwiki-logo-01.png?nolink |}}
 +  * Homepage: [[https://www.splitbrain.org/projects/dokuwiki|DokuWiki]]
 +  * [[DokuWiki as landing page]]
 +
 +**DokuWiki** «Докувики» — это MustHave Бубен совместимый со стандартами и лёгкий в использовании, предназначенная в первую очередь для создания разного рода документации. Она ориентирована на команды разработчиков, рабочие группы и небольшие компании. Все данные хранятся в простых текстовых файлах, поэтому для работы не требуется система база данных. Простой, но мощный синтаксис облегчает создание структурированных текстов и позволяет при необходимости читать файлы данных даже за пределами Wiki. [[robots]].txt для DokuWiki.
 +====== Быстрая инсталляция DokuWiki + настройки ======
 +
 +
 +Подробную установку смотрите на официальном сайте: [[https://www.dokuwiki.org/start?id=ru:install|Установка DokuWiki]].
 +<code>
 +# wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-12-25c.tgz
 +# tar -xzvf dokuwiki-2009-12-25c.tgz
 +# mkdir /var/www/dokiwikiadm
 +# cp -Ra dokuwiki-2009-12-25/* /var/www/dokiwikiadm/
 +# chown -R www-data:www-data /var/www/dokiwikiadm/
 +</code>
 +Создадим виртуальный хост в Apache
 +<code>
 +# nano dokuwikiadm.conf
 +<VirtualHost *:80>
 +        ServerName dokuwikiadm.example.com
 +        ServerAdmin webmaster@localhost
 +        DirectoryIndex index.php
 +
 +        DocumentRoot /var/www/dokiwikiadm
 +        <Directory /var/www/dokiwikiadm/>
 +                Options FollowSymLinks MultiViews
 +                AllowOverride All
 +                Order allow,deny
 +                allow from all
 +        </Directory>
 +</VirtualHost>
 +# a2ensite dokuwikiadm.conf
 +# /etc/init.d/apache2 reload
 +</code>
 +Открываем в браузере http://your_virtual_domen/install.php и следуем инструкции по установке. Удаляем install.php.
 +
 +**Настройки Вики**:
 +  * Транслитерация в именах страниц: полная транслитерация
 +  * Удобочитаемые адреса (URL): .[[htaccess]]
 +  * Задержку индексирования, измененной страницы, устанавливаем в 1 день, вместо 5 по умолчанию (Значение по умолчанию: 60*60*24*5 (60 сек. × 60 мин. × 24 ч. × 5 дн. — т. е. пять дней)). indexdelay:60*60*24*1 Для выключения отложенного индексирования установить её в «0».
 +  * sitemap:5
 +
 +===== 2 способа добавит Google Tag Manager в Dokuwiki =====
 +
 +Чтобы не вставлять напрямую на сайт коды Яндекс Метрики и Google Analytics правильно всего использовать GTM. Регистрируем наш сайт в Google Tag Manager ([[https://tagmanager.google.com]])
 +
 +**1 способ:**
 +  - Устанавливаем компонент https://www.dokuwiki.org/plugin:googletagmanager
 +  - В меню "Настройки вики"=>"Googletagmanager" задаем ID нашего сайта из кода выданного GTM.
 +<WRAP center round alert 60%>
 +После установки Google Tag Manager прекрасно работает, но на сайте появляются 2 критические ошибки [[https://validator.w3.org|Валидатор Nu Html Checker W3]].
 +{{ ::validator_errors.jpg?nolink&400 |}}
 +Подобных ошибок, да и всех остальных, рекомендую избегать, особенно для информационных сайтов!
 +</WRAP>
 +
 +**2 способ:** Ручками добавляем код в файлы шаблона
 +  - Создаем файл lib/tpl/dokuwiki/meta.html и в него добавляем основной код. Это безопасное добавление, после обновления движка, это код не затрется.
 +  - lib/tpl/dokuwiki/main.php добавляем вторую часть код, после body<file php>
 +</head>
 +<body>
 +<!-- Google Tag Manager (noscript) -->
 +</file>Здесь будьте осторожны, код может быть затерт при обновлении Dokuwiki. Наслаждайтесь работой без ошибок!!
 +===== Добавление кода Adsense в DokuWiki шаблон и sidebar =====
 +
 +Все найденные плагин для подключения Google AdSense показались мне старыми: [[https://github.com/dmeziere/dokuwiki-adsense-plugin|adsense-plugin]]. Потому принял решение код вставить ручками в шаблон DokuWiki. 
 +
 +Согласно мануалу, для безопасного добавления дополнительного HTML или [[PHP]] к шаблону и чтобы при обновлении движка DokuWiki ваш код не затирался, создайте ваш файл в любом каталоге шаблонов (lib/tpl/dokuwiki/) или ваш conf/ каталоге. Файлы которые подключаются автоматически:
 +
 +^ Название файла               ^ Позиция вашего HTML                                                ^
 +| ''meta.html''          | Inside the HTML <head>, use this to add additional styles or metaheaders |
 +| ''sidebarheader.html'' | В верху сайдбара, перед текстом (если существует) |
 +| ''sidebarfooter.html'' | В низу сайдбара, после текста (если существует) |
 +| ''pageheader.html''    | На странице статьи, выше текстового контента |
 +| ''pagefooter.html''    | На странице статьи, ниже текстового контента |
 +| ''header.html''        | Шапка сайта, выше logo и wiki title |
 +| ''footer.html''        | Подвал сайта, после любого контента на странице |
 +
 +**Включение рекламы AdSense на правом сайдбаре:**
 +  - Шаблон должен поддерживать сайдбар, [[https://www.dokuwiki.org/template:dokuwiki#changing_the_width_and_other_styles|DokuWiki шаблон по умолчанию]] его поддерживает.
 +  - Включить в настройках: "Параметры «Докувики»"->Основные параметры->sidebar  Значение по умолчанию:sidebar
 +  - Перейдите по адресу http://your-wiki.com/doku.php?id=sidebar, нажмите кнопку «Создать страницу», отредактируйте эту страницу, сохраните, и боковая панель готова. Это всё, сохраненные изменения будут отображаться на боковой панели. Страница не должна быть пустой, я поставил только знак точки.
 +  - В lib/tpl/dokuwiki создадим sidebarheader.html в который добавим код AdSense
 +
 +Наслаждаемся рекламой на своем сайте!:))
 +
 +==== Как добавить кода Adsense в DokuWiki после H1? ====
 +
 +Для добавления кода Adsense после первого H1, нужно отредактировать  функцию header в файле  <dokuwiki installation directory>/inc/parser/xhtml.php. 
 +
 +Находим строку <file php>
 +$this->doc .= "</h$level>".DOKU_LF;
 +</file> и заменяем ее на код<file php>
 +        $this->doc .= "</h$level>";
 +        if ($level == 1) {
 +            $this->doc .= '
 +<!--noindex-->
 +
 +КОД из AdSense
 +
 +<!--/noindex-->
 +<br />';
 +        }
 +
 +        $this->doc .= DOKU_LF;
 +</file>
 +==== Как вставить видео с youtube в dokuwiki ====
 +
 +Для вставки видео с youtube я использую плагин [[https://www.dokuwiki.org/plugin:vshare|Video Share Plugin]], синтаксис: <file>
 +{{youtube>LWM8YxwqEU}}
 +</file>В следующем примера расположить видео по центру, большого размера.
 +<file>
 +{{ youtube>LWM8YxwqEU?large }}
 +</file>
 +===== Инсталляция Dokuwiki в Microsoft Azure Web App =====
 +
 +Инсталляция Dokuwiki в [[Microsoft Azure]] Web App. Нужно создать файл **web.config** для http сервера [[IIS]], который защитит наши рабочие директории от несанкционированного доступа.<file xml web.config>
 +<?xml version="1.0" encoding="UTF-8"?>
 +<configuration>
 +   <system.webServer>
 +      <security>
 +         <requestFiltering>
 +            <hiddenSegments>
 +               <add segment="conf" />
 +               <add segment="data" />
 +               <add segment="inc" />
 +            </hiddenSegments>
 +         </requestFiltering>
 +      </security>
 +   </system.webServer>
 +</configuration>
 +</file>В листинг не добавлена директория “bin”, потому что к папке с таким названием доступ в IIS закрыт по умолчанию.
 +===== Плагины DokuWiki =====
 +  * [[http://www.dokuwiki.org/plugin%3Anote|Плагин note]] - данные плагин позволяет выделить текст в виде заметки. http://dokuwiki.ru/plaginy?do=show
 +  * [[http://www.dokuwiki.org/plugin%3Acacherevisionseraser|СacheRevisionsEraser]] - очищает кэш и удаляет старые версии документов.
 +  * [[http://www.dokuwiki.org/plugin:codebutton|codebutton]] - добавляет кнопку позволяющую вставлять код, например<file>
 +Insert Code
 +</file>
 +  * [[http://www.dokuwiki.org/template:navigation|Navigation Issues]] - шаблон
 +  * [[http://www.dokuwiki.org/plugin%3Aboxes|plugin:boxes]]- позволяет оформлять «боксы» в самых различных цветовых комбинациях. [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/tutorial/boxes|Примеры оформления]].
 +<box> the box contents </box>
 +<box 80% round red|a title> the box contents </box>
 +  * [[https://www.dokuwiki.org/plugin:wrap|Wrap Plugin]]
 +  * [[https://www.dokuwiki.org/plugin:translation|Translation Plugin]]
 +  * [[https://www.dokuwiki.org/plugin:vshare|Video Share Plugin]]
 +
 +===== 4 SEO плагина для DokuWiki =====
 + 
 +  * [[https://www.dokuwiki.org/plugin:htmlmetatags|HtmlMetaTags Plugin]] SEO плагин, позволяет задавать open graph, description и т.д.
 +Для использования вписываем в страницу в таком виде<file javascript>
 +{{htmlmetatags>metatag-robots=() 
 +metatag-keywords=(apfel,bananne,birne) 
 +metatag-description=(Allgemeiner Obstbauer)
 +metatag-media-og:image=(:wiki:image.jpg)
 +metatag-og:description=(anything else)
 +metatag-og:any=(anything else 2)
 +}}
 +</file>Результат
 +<file html>
 +<meta name="robots" content="noindex,nofollow"/>
 +<meta name="keywords" content="apfel,bananne,birne"/>
 +<meta name="description" content="Allgemeiner Obstbauer"/>
 +<meta property="og:image" content="http://localhost/lib/exe/fetch.php?media=wiki:image.jpg"/>
 +<meta property="og:description" content="anything else"/>
 +<meta property="og:any" content="anything else 2"/>
 +</file>
 +  * [[https://www.dokuwiki.org/plugin:meta|Meta Plugin]]
 +  * [[https://www.dokuwiki.org/plugin:tag|Tag Plugin]]
 +  * [[https://www.dokuwiki.org/plugin:pagetitle|PageTitle Plugin]] - задать тег title для страницы <file bash>
 +~~Title: Page Title plugin for DokuWiki ~~
 +</file>
 +===== Карта сайта DokuWiki sitemap =====
 +
 +Карта сайта ([[sitemaps]]) создаётся, если включена опция «sitemap». Файл карты находится во вложенном каталоге «cache» вашей установки «ДокуВики». Он будет доступен по ссылке: http://your_domain/dokuwiki/?do=sitemap. В зависимости от наличия поддержки gzip в вашем PHP, файл будет именоваться «sitemap.xml.gz» (если gzip доступен) или «sitemap.xml» (если gzip недоступен). Почти во всех современных установках PHP поддержка gzip включена, поэтому файл будет называться скорее всего «sitemap.xml.gz».
 +
 +
 +<note>Карта сайта будет содержать только ссылки на страницы, которые доступны без авторизации на сайте.</note>
 +
 +===== DokuWiki print.css вывод на печать =====
 +Если возникла надобность при выводе на принтер удалить какие-то объекты или изменить шрифт, можно дополнить/изменит файл lib/tpl/dokuwiki/css/print.css. Это изменит тип [[css#css_-_vyvod_na_pechat|media CSS]]. Например, скроем при печати :<file css print.css>
 +#footer2d,
 +#dokuwiki__header,
 +#dokuwiki__footer {
 +    display: none;
 +}
 +</file>
 +===== DokuWiki добавить CSS файл =====
 +
 +В DokuWiki предусмотрено добавление пользовательских стилей изначально. Для этого требуется создать файл conf/userstyle.css, в который и нужно вписывать CSS правила. Например, для картинок, окруженных div c классом начинающимся на iam_img, задать круглые углы:<file css>
 +div[class^="iam_img"] img {
 +    border-radius: 10px;
 +}
 +</file>Другие варианты добавления CSS смотрите по ссылке: [[https://www.dokuwiki.org/devel:css|DokuWiki CSS Stylesheets]]
 +===== DokuWiki загрузка своего javascript кода =====
 +
 +Подробно: [[https://www.dokuwiki.org/ru:devel:javascript|Загрузка JavaScript]]
 +
 +  * Для внешней ссылки удалить атрибут rel="[[nofollow]]", чтобы разрешить поисковым системам следовать по ней (передача веса). Создадим файл conf/userscript.js Он автоматически загрузится
 +<file javascript>
 +function doFollow1(){
 + jQuery("a[href^='https://example.com']").removeAttr("rel");
 +}
 +
 +jQuery(function () {
 +    jQuery(document).click(doFollow1);
 +});
 +</file>
 +===== Dokuwiki sitemap.xml и настройка Яндекс =====
 +
 +  * [[http://dokuwiki.ru/sitemap|Карта сайта (sitemap)]]
 +  * [[https://www.dokuwiki.org/ru:sitemap|Карта сайта (sitemap)]] - практически идентична первой
 +
 +Мой настройки для Яндекс Вебмастера, чтобы он корректно увидел sitemap.xml. Добавляем директивы Host и Sitemap в файл [[robots]].
 +
 +<file bash robotx.txt>
 +User-agent: *
 +Disallow: /bin/
 +Disallow: /conf/
 +Disallow: /inc/
 +Disallow: /lib/
 +Disallow: /vendor/
 +Host: wiki.dieg.info
 +Sitemap: http://wiki.dieg.info/sitemap.xml.gz
 +</file>
 +В файл .htaccess добавляем строку
 +<file bash>
 +# sitemap for Yandex
 +RewriteRule ^sitemap\.xml\.gz$        doku.php?do=sitemap [L]
 +</file>
 +<note tip>Так же sitemap.xml.gz можно добавить в Google Search Console, у меня до этих изменений Google  видел его в виде **/?do=sitemap**</note>
 +
 +===== DokuWiki заменить значок неупорядоченного списка ul =====
 +
 +**1 вариант:**
 +  - Подготавливаем картинку 16х16 пикселей.
 +  - Заливаем её lib/tpl/dokuwiki/images/tambourine_16x16.png
 +  - В файле lib/tpl/dokuwiki/css/basic.less исправить определение<file сss>
 +ul { list-style: square outside; }
 +</file>на<file сss>
 +ul { list-style-image: url('images/tambourine_16x16.png'); } /* your image */
 +</file>
 +
 +В оглавлении страницы заменить файл /lib/tpl/dokuwiki/images/toc-bullet.png
 +
 +**2 вариант:**
 +В файле lib/tpl/dokuwiki/css/_links.css добавляем css код list-style: lower-greek;:
 +<file css>
 +.dokuwiki .page ul li, .dokuwiki .aside ul li {
 +        /*list-style: hangul-consonant;*/
 +        list-style: lower-greek;
 +}
 +</file>
 +====== Ссылки ======
 +  * [[http://www.dokuwiki.org/ru:dokuwiki|Руководство по DokuWiki]]
 +  * [[http://www.dokuwiki.org/ru:mime|Конфигурация MIME]] - какие файлы можно загружать.
 +  * [[http://dokuwiki.ru/installjacija_dokuwiki|Инсталляция DokuWiki]]
 +  * [[http://dokuwiki.ru/plaginy|Плагины DokuWiki]]
 +  * [[http://www.dokuwiki.org/ru:plugins|Плагины]]
 +  * [[http://www.dokuwiki.org/install:upgrade|Upgrading DokuWiki]]
 +  * [[http://www.dokuwiki.org/security|Security DokuWiki]] [[https://www.dokuwiki.org/ru:security|Безопасность «ДокуВики» ]]
 +  * [[https://www.dokuwiki.org/ru:devel:templates|Разработка шаблонов «ДокуВики»]]
 +  * [[https://www.dokuwiki.org/ru:rewrite|ЧПУ URL-преобразование]]
 +  * [[https://www.dokuwiki.org/ru:devel:css|«ДокуВики» и таблицы стилей CSS]]
  
dokuwiki.txt · Последнее изменение: 2020/06/13 13:45 (внешнее изменение)