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

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


dokuwiki

Различия

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

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

dokuwiki [2018/08/31 03:18] (текущий)
Строка 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: [[http://​www.splitbrain.org/​projects/​dokuwiki|DokuWiki]]
 +
 +**DokuWiki** «Докувики» — это MustHave Бубен совместимый со стандартами и лёгкий в использовании,​ предназначенная в первую очередь для создания разного рода документации. Она ориентирована на команды разработчиков,​ рабочие группы и небольшие компании. Все данные хранятся в простых текстовых файлах,​ поэтому для работы не требуется система база данных. Простой,​ но мощный синтаксис облегчает создание структурированных текстов и позволяет при необходимости читать файлы данных даже за пределами Wiki. [[robots]].txt для DokuWiki.
 +====== Быстрая инсталляция DokuWiki + настройки ======
 +
 +
 +Подробную установку смотрите на официальном сайте: [[http://​www.dokuwiki.org/​ru%3Ainstall|Установка 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 шаблон =====
 +
 +Все найденные плагин для подключения 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 · Последние изменения: 2018/08/31 03:18 (внешнее изменение)