worldwide open-source software - wiki:tips

action_menu

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:17:34 +0000

Action menu

Это изменение поможет добавить на панель кнопок выпадающий список, как в MoinMoin Wiki или GMail

Добавьте эту функцию, например в \tpl\<имя вашего шаблона>\main.php (так же можно ее добавить в /inc/html.php):

Предупреждаю, код очень корявый, т.к. я с php совсем плохо. Но за то работает

/**
 * Create actions select box
 *
 * Create actions select box
 *
 * @author Kirill Bezrukov <kirbez@mail.ru>
 */
function tpl_select_actions(){
  global $ID;
  global $INFO;
  global $REV;
  global $ACT;
  global $conf;
  global $lang;
  global $auth;
 
	if($ACT == 'show' || $ACT == 'search'){
		if($INFO['writable']){
			if($INFO['exists']){
			  print '<select class="edit" name="actionmenu" onchange=
						"if ((this.selectedIndex != 0) &&
								(this.options[this.selectedIndex].disabled == false)) {
							location.href = this.options[this.selectedIndex].value;
						}
			            this.selectedIndex = 0;" >'. DOKU_LF;	
				print '  <option value="show">Actions:</option>'.DOKU_LF;
				print '  <option value="'.wl($ID,'do=export_raw').'">Raw view</option>'. DOKU_LF;
			        print '  <option value="'.wl($ID,'do=export_html').'">HTML view</option>'. DOKU_LF;
			        print '  <option value="'.wl($ID,'do=export_odt').'">Export to OpenDocument</option>'. DOKU_LF;
			        print '  <option value="show" disabled="disabled" class="disabled">--------------------</option>'. DOKU_LF;
			        print '  <option value="'.wl($ID,'purge=true').'">Recache</option>'. DOKU_LF;
				print '  <option value="'.wl($ID,'do=admin&page=acl').'">ACL</option>'. DOKU_LF;
				print '  <option value="'.wl($ID,'do=admin&page=pagemove').'">Page move</option>'. DOKU_LF;
				print '</select>';	
		  }
		}
	}
 
  return true;
}

В идеале надо сделать что-то типа html_btn, и чтобы плагины могли сами регистрироваться в этом списке.

and this to the top bar div:

    <div class="bar" id="bar__top">
      <div class="bar-left" id="bar__topleft">
        <?php tpl_button('edit')?>
        <?php tpl_button('history')?>
++	<?php tpl_select_actions()?>
      </div>

— Kirill Bezrukov 2008/03/18 10:03

blogging

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:50:34 +0000

Блог на «Докувики»

Страница в РАЗРАБОТКЕ! Если вы видите, что можно добавить, добавляйте без сомнения!

Несмотря на то, что блоги не является основным предназначением «Докувики», есть немало плагинов, позволяющих превратить «Докувики» в полноценную платформу для блога.

На этой странице приведены основные шаги, благодаря которым можно начать деятельность блоггера на движке «Докувики». Здесь также можно узнать, как обойти возможные проблемы.

Желающие найти существующие блоги на основе «Докувики» могут посетить Planet DokuWiki, или воспользоваться поиском: inurl:doku.php+inurl:blog.

Необходимые плагины

В первую очередь стоит поставить несколько плагинов. Основной «набор блоггера» составляют blog, include и pagelist. Они составляют необходимый минимум.

В дополнение к необходимым можно добавить discussion, linkback, bloglinks, feedmod, avatar и tag.

Основная масса этих плагинов зависит друг от друга. В помощь начинающим существует Blogsuite Bundle Hub. Ссылка не действует! ответ 404 Здесь можно взять самое необходимое в виде одного архива и установить посредством центра управления плагинами (Внимание плагины в пакете могут быть устаревшими, следите за версиями).

Настройка

Индивидуальный блог

В этом случае у нас только один пользователь, и один блог, который нужно вести. В настройках блога можно указать пространство имён, в котором будут сохранены записи. По умолчанию там указано :blog, и этого вполне достаточно для большинства.

Перед созданием блога следует решить, какая страница будет «лицом» блога, и создать её. Если хочется, чтобы блог был на стартовой странице, то ей будет :start. На ней следует разместить синтаксическую вставку блога и сохранить.

{{blog>?5}}

Эта вставка отобразит 5 последних записей в блоге. Раз это индивидуальный блог, нет необходимости указывать, из какого пространства имён следует брать записи. Но перед добавлением первой записи следует обратить внимание на пункт конфигурации dateprefix. При помощи него можно указать, под какими именами будут создаваться новые записи. Достаточно удачной установкой может послужить %Y:%m%d_. Если вы назовёте запись «Мой новый блог», то страница будет создана под именем blog:2008:0512_мой_новый_блог. Как видно из примера, это позволяет держать пространство имён блога в порядке.

Чтобы другие не могли редактировать ваш блог, следует обратиться к ACL и назначить там несколько правил (для примера — блог на стартовой странице).

start    @ALL 1
start    вашник 16
blog:*   @ALL 1
blog:*   вашник 16

Многопользовательский

Это случай, когда мы хотим разрешить пользователям вести свои блоги. Для этого каждый пользователь должен обзавестись своим собственным пространством имён для блога, где только он может распоряжаться содержимым. Для примера возьмём трёх пользователей: Васю, Петю и Машу. Каждый пользователь получает собственное пространство в пространстве :blog и собственную страницу с лентой там же. Теперь нужно установить права доступа для каждого (к примеру, для Васи):

blog:вася    @ALL 1
blog:вася:*  @ALL 1
blog:вася    joey 16
blog:вася:*  joey 16

Now you have to create the page :blog:joey and insert the following blog plugin syntax to setup the blog. После этого следует создать страницу пользователю :blog:вася, куда поместить вставку для блога.

{{blog>blog:вася?5}}

То же самое надо повторить для всех остальных пользователей. После этого каждый может начать вести блог.

Настройка новостной ленты

Одной из важнейших вещей в блоге является RSS-лента. «Докувики» автоматически создаёт все виды лент, однако может потребоваться настроить одну ленту специально для блога.

Примечание: С тех пор как «Докувики» стал создавать полноценный HTML в лентах, не рекомендуется использовать плагин feed (хотя он всё ещё полезен для обсуждений).

URL новостной ленты

Необходимо несколько параметров, чтобы создать RSS-ленту. Первый, и самый необходимый — ns, который ограничит ленту только записями в блоге. Не стоит в RSS давать стартовую страницу — так вы получите все записи в виде одной записи в ленте!

Вот пример простого адреса ленты:

http://www.example.com/feed.php?ns=blog&num=10

Следует также убедиться, что ссылки на ней ведут к актуальной версии страницы. Это можно установить в настройках или передать в внутри адреса:

http://www.example.com/feed.php?ns=blog&num=10&linkto=current

Также вполне возможно, следует включить HTML в ленте:

http://www.example.com/feed.php?ns=blog&num=10&linkto=current&content=html

Красивые адреса лент посредством .htaccess

Если включено переписывание адресов посредством .htaccess, то можно добавить специальные правила и получить красивые адреса для лент. Правило для приведённого выше адреса будет выглядеть следующим образом:

RewriteRule ^_feed/(.*) feed.php?ns=$1&num=10&linkto=current&content=html [QSA,L]

Его можно добавить рядом с правилом для _export.

Теперь ленту можно получить по адресу http://yourdomain.org/_feed/blog.

Автоматическое обнаружение лент

Браузеры могут сами обнаруживать RSS-ленты, анализируя специальные метаданные в HTML. По умолчанию «Докувики» предоставляет стандартные ленты сам. В нашем случае предпочтительнее отключить стандартные, а добавлять только собственно ленту блога. Это можно сделать, исправив в используемом шаблоне оформления main.php. Вот пример заголовка:

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title><?php tpl_pagetitle()?> [<?php echo strip_tags($conf['title'])?>]</title>
 
  <?php tpl_metaheaders(false)?>
  <link rel="alternate" type="application/rss+xml" title="Blog" href="/feed.php?ns=blog&amp;linkto=page" />
</head>

Обратите внимание на параметр false, передаваемый функции tpl_metaheaders. Это подавляет все стандартные теги обнаружения лент.

Использование

Черновики

С черновыми записями можно обращаться двумя основными способами. Первый способ — завести отдельное пространство имён для черновиков. Чтобы опубликовать статью, достаточно будет скопировать её в блог. Второй способ представляет сам плагин blog. Он позволяет пометить черновик вставкой маркера ~~DRAFT~~ в текст перед сохранением. Тогда она не будет отображаться в блоге до тех пор, пока вы снова не уберёте маркер из текста. При использовании этого способа следует также поставить плагин feedmod, который удалит черновики из RSS-ленты.

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

Управление комментариями

Плагин discussion предоставляет панель управления в административном интерфейсе «Докувики», где можно открывать и закрывать обсуждения, а также производить действия над отдельными комментариями.

Управление обратными ссылками

Плагин linkback даёт возможность управлять обратными ссылками через административный интерфейс «Докувики» — удалять их или включать и выключать на отдельных страницах.

Управление метками

Плагин tag последней версии даёт возможность управлять метками, перестраивать индекс меток через административный интерфейс. Посредством плагина tagentry можно получить дополнительные возможности по управлению метками.

Украшение

Отображение только первого подраздела страницы

Иногда нежелательно отображать всю длинную статью в блоге на первой странице. Обрезать её можно добавив пустой заголовок первого уровня. Чтобы это сработало следует добавить параметр firstseconly в плагине include.

Далее будет длинная статья.

====== ======

Собственно длинная статья здесь.

Тонкая настройка ленты

Стандартная RSS-лента «Докувики» не слишком пригодна для ведения блога. К примеру, она в заголовок ставит название страницы, а не первый заголовок внутри статьи. Это можно исправить при помощи плагина feedmod. Добавляет заголовок статьи в ленту, а также включает в новость метки и ссылки на обсуждение. Также можно добавить ссылки для добавления в закладки, для чего стоит отредактировать шаблон «подвала» новости (подробности на feedmod).

Другой простой путь добавить функций — использовать Feedburner. Зарегистрируйтесь на том сайте, добавьте туда свою ленту (см. URL новостной ленты) и добавьте ленту Feedburner в метаданные. Эта операция также перенесёт часть нагрузки с вашего сайта на Feedburner.

Борьба со спамом

Спам в комментариях — серьёзная проблема в наши дни. К счастью «Докувики» предоставляет ряд антиспам-плагинов для борьбы с ним. Также поддержка captcha встроена в плагин discussion. Всё что нужно — это установить нужные средства и настроить их.

Проблемы

Treat your filesystem carefully

Хитрости

Правка неверных дат

Some timestamp issues I came across:

As mentioned in the discussion of the meta plugin, feed.php ignores settings of . (Usually getRecents() from changelog.php is called, which doesn't seem to support it?) This results in a mismatch between blog listing like {{blog>blog?5}} and feed.php?ns=blog&num=5, which is unexpected.
Also, it is currently not possible to let feed.php list only newly created pages (and sort them by descending creation date). (Because getRecents() does provide listing only newly created pages.) I note that this listing is possible with the changes plugin, but this code isn't used in feed.php.
An alternative approach using alphabetic ordering of pages by name could also solve issues if the items have pagenames like :blog:YYYY-MM:DD-pagetitle or similar. Then the feed.php is consistent with the permalinks of the blog, which would be nice.

— Louwrens van Dellen 2010/05/03 23:23

Обсуждение

Изменение порядка следования «обратных ссылок» и «обуждения» на странице

Is it possible (without changing source/templates) to change the order of the discussion and the linkback plugin? If there is no way without editing, could anybody who is more often editing the code than me, give a hint into the right direction? (I am «speaking» HTML/CSS/PHP)

Thanks, Ralf

cms

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:56:37 +0000

Использование «Докувики» в качестве простой системы управления содержимым

Вики-движки изначально приспособлены для совместной работы в открытой среде. То же самое можно сказать и про «Докувики». Тем не менее «Докувики» предоставляет возможности для реализации более «традиционной» системы управления содержимым (CMS). На этой странице будет вкратце рассказано, как использовать «Докувики» в качестве CMS.

Некоторые шаги подобны применению «Докувики» в качестве движка для блога, так что про блок тоже стоит прочесть.

В РАЗРАБОТКЕ

Также на странице «решение — CMS» можно узнать о других разработках на поприще CMS-строения.

Настройка

Настройка прав доступа

Основное отличие системы управления содержимым от вики в доступе к изменению содержимого. В первом случае требуется ограничить круг редакторов малой группой или одним человеком. Это несложно сделать в «Докувики» при помощи ACL

Для этого необходимо дать права на чтение группе @ALLв пространстве имён *, а группе редакторов — больше полномочий.

Отключение функций вики

Многие возможности «Докувики» бесполезны или вовсе нежелательны в CMS. Движок позволяет отключить различные функции при помощи настройки disableactions. В CMS возможно потребуется отключить регистрацию, обратные ссылки, индекс, недавние изменения, историю страниц, подписку, подписку на пространство имён и исходный текст.

Шаблон оформления

Шаблон должен скрывать кнопки редактирования от незарегистрированных пользователей. Этого можно добиться изменением переменной $_SERVER['REMOTE_USER'].

Для оформления «обычных» сайтов нередко используются шаблоны «dokucms» (есть примеры) и «mcz».

Добавление доступной отовсюду навигации

Классическую боковую панель для меню, форм поиска и обратной связи можно добавить при помощи плагинов вроде sidebar или sidebarng.

Правка сообщений

Некоторые сообщения, отображаемые движком могут быть неприемлемы в режиме CMS. В основном это касается отсутствующих страниц, где предлагается их создавать. Это исправить можно изменением файлов inc/lang/<yourlanguage>/*.txt.

Только убедитесь, что копии изменений сохранены, так как будут переписаны при ближайшем обновлении¹⁾.

Также неплохо будт включить пункт конфигурации send404.

Оформление

Многие отказываются от идеи использовать вики-движок в качестве CMS. Обычная причина — они представляют оформление в стиле «Википедии» или «Докувики» со всеми их кнопками и меню.

Однако подогнать «Докувики» под свои требования и предпочтения так же просто как любую другую CMS, сохранив при этом всю функциональность вики-технологии — лёгкая правка, управление редакциями, виртуальные включения и отсутствие потребности в базе данных.

Вот несколько примеров:

¹⁾

В версии 2011-05-25 Rincewind появилась возможность хранить переводы отдельно в каталоге conf, так что рекомендация, похоже, устарела

extern-links-with-icons

anonymous@undisclosed.example.com (Anonymous) — Sun, 19 Jan 2025 10:53:56 +0000

Внешние ссылки со значками

Отредактируйте файл _links.css или design.css, изменив описание для «div.dokuwiki a.wikilink1»:

/* внешние ссылки */
.dokuwiki a.urlextern {
    background-image: url(../../images/media_link_displaylnk.png);
}

Отключить иконки ссылок

Отключить значки у ссылок можно в файле _links.css или design.css в каталоге используемого вами шаблона lib\tpl\имя_шаблона\css. Для отключения отображения значков внешних ссылок достаточно закомментировать всю секцию external link

_links.css

/* external link */
div.dokuwiki a.urlextern {
  background: transparent url(images/link_icon.gif) 0px 1px no-repeat;
  padding: 1px 0px 1px 16px;
}

Либо в «koas»

_links.css

/* external link */
.dokuwiki a.urlextern {
    background-image: url(../../images/external-link.svg);
}

farm

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:52:00 +0000

Вики-фермы

Эта страница содержит обзор различных способов настройки вики-ферм.

На вики-ферме имеется только один экземпляр вики-движка (родитель вики или контроллер фермы или фермер) с единой комплексной подборкой дизайн-шаблонов и плагинов + несколько вики (дочерние экземпляры или животные) с раздельными друг от друга данными, выборками плагинов, дизайн-шаблоном и их настройками. Самыми большими преимуществами вики-фермы являются экономные по времени обслуживание и модернизация вики-движка сразу для группы проектов.

Структура каталогов вики-фермы

Каталог вики-фермы может быть теоретически в любом месте файловой системы, но мы рекомендуем следующую структуру:

/var/www/dokuwiki – движок ДокуВики
/var/www/farm – содержит всех животных
- /var/www/farm/animal1 — первая вики
- /var/www/farm/animal2 — вторая вики
- и т.д.

Доступные методы

Есть разные способы, чтобы создать вики ферму. Они описаны на следующих страницах:

Недавно:

Официальная документация по вики-фермам - наиболее прямой способ установки
Расширенная установка вики-ферм
Обсуждение настройки вики-ферм (англ.)

Давно:

Перенаправление фермы, используя реконфигурации VirtualHosts или файлов .htaccess и несколько сценариев PHP
Плагин фермы, автоматизированная версия перенаправления
Сим-вики-ферма концептуально проще, состоит из отдельных вики, переходящих на общие каталоги через символические ссылки

good_style

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:57:59 +0000

Советы по соблюдению стиля

Несколько советов, как писать хорошие вики-страницы.

Структура страницы

Начинайте свою страницу с заголовка первого уровня с использованием значимого (осмысленного) названия.
Располагайте вложенные заголовки в правильном порядке, секции второго уровня должны начинаться с заголовка второго уровня.
Разбивайте текст на абзацы, оставляя одну пустую строку между ними. В среднем абзац не должен превышать 10–20 строк.
Если текст длиннее нескольких (3–5) абзацев, подумайте над разделением его на секции путём добавления заголовков первого-пятого уровней.
Когда текст становится больше двух-трёх экранных страниц, разместите краткое содержание страницы после первого заголовка. Когда страница станет значительно больше, попробуйте разделить её на несколько страниц.
Если много ссылок ведут на другие страницы вики или внешние ссылки, добавьте специальный раздел со ссылками. (Подробности ниже).
Если большинство страниц пространства имён имеют одинаковую структуру, добавьте шаблон страницы, и каждая новая страница будет создаваться на основе одного и того же «скелета».
Старайтесь не усложнять структуру системы пространств имён. Старайтесь использовать для них короткие, простые для запоминания названия.
Прислушивайтесь к рекомендациям плагина проверки качества о структуре и форматировании текста.

Форматирование текста

Акцентируйте отдельные слова или короткие отрывки текста жирным шрифтом или курсивом. Выберите один из них и придерживайтесь этого выбора.
Выберите стиль отображения текста и интерфейса, например, кнопок и пунктов меню, и последовательно применяйте этот стиль. Было бы хорошо добавить страницу, на которой будут излагаться правила оформления вашей вики.
Используйте маркированные списки для значений, независимых друг от друга. Если вы пишете список целей, делайте это в строку.
Используйте сноски редко и только для очень коротких дополнительных пометок. Если сноска получается длинной, выделите её в отдельную вики-страницу. Если вы хотите сослаться на другой (внешний) ресурс, используйте ссылки.
Таблицы могут сильно улучшить читабельность структурированной информации. Если вы вставляете таблицу, убедитесь, что у неё есть значимые заглавные ячейки и подпись явно соответствует содержанию таблицы (например, «Таблица 1.2. Средние расстояния между планетами»).
Большие таблицы очень тяжело редактировать. Попробуйте вместо них применять вложенные списки.

Язык (слог)

Начинайте каждое предложение с заглавной буквы и заканчивайте точкой или другим подходящим знаком препинания.
Старайтесь писать короткие, ясные предложения, не усложняя их. Когда вы посчитаете, что закончили страницу, прочитайте её ещё раз и исправьте все слишком сложные предложения.
Решите, как обращаться к читателю. Так как «ДокуВики» обычно используется для написания документации, вам часто придётся инструктировать читателя, объяснять ему, как делать некие вещи. Вы можете использовать побудительную форму («Делай это»), или обращаться безлично («Нужно сделать то-то»). В первом случае нужно выбрать обращение на «ты» или «вы». И всегда придерживайтесь выбранного стиля.
Перед сохранением проверяйте страницу на грамматические ошибки и опечатки. Если в тексте много ошибок, это снизит убедительность статьи независимо от содержащейся в ней информации.
Выработайте собственный стиль. Не заставляйте себя писать в некомфортной для себя манере. Это будет лишь ненатурально выглядеть и неприятно читать.

Ссылки

Когда вы используете термин, требующий объяснения, добавьте новую вики-страницу и сошлитесь на неё.
Перепроверьте свою страницу перед тем, как закончите её редактировать, и добавьте ссылки на существующие вики-страницы основных терминов вашей статьи.
Не добавляйте ссылку при каждом употреблении специфического термина. Сделайте ссылку для первого или самого заметного употребления, и, возможно, в разделе ссылок.
Давайте ссылки на источники изображений, данных и цитат.
Подумайте о разделе «Смотри(те) также» в конце вашей статьи. Давайте в нём ссылки на вики-страницы, которые близко связаны со статьёй.
Если хотите указать внешние ресурсы, на которых можно найти дополнительную информацию по вашей теме, или которые вы использовали для написания статьи, создайте в её конце секцию «Ссылки» или «Дополнительная информация». В ней дайте список ссылок или других указателей (например, номеров ISBN). Напишите пояснения к ссылкам, если не сделали этого в основном тексте.
Использование ярлыков интервики может помочь в связывании с общими ресурсами.

Изображения и медиафайлы

«Картинка говорит больше, чем тысяча слов». Это также означает — больше, чем вы собирались сказать. Люди меньше сомневаются в достоверности изображений, чем слов. Короткое текстовое описание — это лучше, чем ничего или неподходящая картинка.
Как и с таблицами, всегда делайте подпись к изображению, которая должна гласить, что вы хотели ею сказать.
Если вы не сами сделали изображение, укажите источник (лучше со ссылкой) и автора (копирайт).
Не вставляйте изображения с внешних сайтов, если это не было позволено явно. Во-первых, могут быть проблемы с авторскими правами, а во-вторых, может расходоваться лишний трафик, если выключена опция кэширования внешних изображений. Загружайте изображения в вики, если есть такая возможность.
Если изображение занимает больше, чем треть страницы, используйте ссылку с инструкцией по изменению размера для вставки эскиза изображения.

httpslogin

anonymous@undisclosed.example.com (Anonymous) — Fri, 09 Aug 2024 01:01:18 +0000

Принудительный вход через HTTPS

Плагины

forcessllogin

См. https://www.dokuwiki.org/plugin:forcessllogin, похоже, не отражает доступ SSL в URL , т.е. страница «Докувики», доступ к которой запрещен, не будет открыта по протоколу https, что затрудняет отладку и обеспечение безопасного входа в систему.

Апачи

Используя mod_rewrite Apache, можно принудительно использовать HTTPS для входа в DokuWiki, тем самым предотвращая передачу паролей в открытом виде.

Вам также может понадобиться, чтобы все запросы (а не только вход) использовали HTTPS. Для этого создайте файл .htaccess в корневом каталоге DokuWiki и вставьте следующий код.

.htaccess

RewriteCond %{HTTPS} !on
RewriteRule (.*) https://%{HTTP_HOST}/$1 [R,L]

Если вы хотите принудительно задать только какой-то определенный URL , сначала прочтите статью о перезаписи URL.

Перенаправление на защищенное соединение, которое ограничено определенным набором страниц (например, страницы входа), требует их распознавания на основе URL . Некоторые страницы (например, страницы «доступ запрещен», которые могут быть включены только в более новых версиях, например, 2014-05-05 «Ponder Stibbons» <ref> https://www.dokuwiki.org/plugin:ondeniedlogin </ref>) не включают такую метку и не могут быть отделены от остальных URL (к которым может потребоваться доступ без защищенного соединения для экономии ресурсов сервера).

Остальная часть параграфа обрабатывает только запросы с ?do=login запросом GET, который не охватывает по крайней мере страницы «доступ запрещен»! Необходимо исследование правила перенаправления для всех запросов аутентификации по HTTP. Смотрите обсуждение для решения.

Далее предполагается, что вы уже настроили поддержку HTTPS для своей вики, сделав ее доступной по HTTP и HTTPS по одному и тому же адресу. По соображениям производительности только вход в систему и обновления профиля должны быть принудительно переведены на HTTPS, в то время как все «нормальные» действия вики будут продолжать работать по HTTP.

Поскольку вам необходимо настроить куки через HTTPS для работы на HTTP, вам необходимо сначала отключить опцию securecookie . Затем приступайте к настройке перенаправления в вашем .htaccess:

# Переключиться на безопасный режим при входе в систему, профиле и действиях администратора 
RewriteEngine On
RewriteCond %{HTTPS} !on
RewriteCond %{QUERY_STRING} do=(log|profile|admin)
RewriteRule ^(.*) https://%{HTTP_HOST}/$1 [R,QSA,L,NE]
 
# Изменить обратно на небезопасный режим при показе действия 
RewriteCond %{HTTPS} on
RewriteCond %{QUERY_STRING} !do=(log|profile|admin)
RewriteCond %{REQUEST_METHOD} GET
RewriteRule ^(.*) http://%{HTTP_HOST}/$1 [R,QSA,L]

Возможно, вы захотите изменить ${HTTP_HOST} его на ${SERVER_NAME}, где имя сервера совпадает с именем хоста в вашем SSL-сертификате.

Примечания:

выше переключает обратно на не-SSL только на действии show. Это означает, что переключение может не произойти немедленно после входа, но гарантирует отсутствие предупреждений о «смешанном контенте» во время операции SSL.
если у вас есть другие правила переписывания, например, те, которые используются при общем переписывании, поместите эти правила перед остальными.
Если каталог установки DokuWiki не является корневым каталогом (например, http://example.com/wiki/) , вам необходимо добавить этот дополнительный путь к строкам 5 и 11 приведенного выше фрагмента, что будет выглядеть примерно так:RewriteRule ^(.*) http://%{HTTP_HOST}/wiki/$1 [R,QSA,L]

защищенный cookie

Обратите внимание: вам необходимо отключить « securecookie », conf/dokuwiki.php чтобы приведенный выше код работал. В противном случае ваши входы не будут успешно регистрироваться. Это происходит потому, что при включенном securecookie сеансовый cookie, созданный во время входа HTTPS, не может быть отправлен по HTTP, и сеанс теряется.

nginx

Такая настройка также возможна в nginx, но с небольшой доработкой fastcgi_params.

Во-первых, вам нужно иметь отдельные экземпляры сервера, для http и https каждый, чтобы поддерживать чистоту (и rewrite не запутаться и не попасть в ловушку redir loops). Это может выглядеть так. Каждый экземпляр имеет свое собственное правило перезаписи для переключения с http на https.

# Протестировано с nginx 0.8.5
# В http-контексте вашей конфигурации nginx
map $scheme $php_https { default off; https on; }
 
    server {
	server_name wiki.host.org
	root /path/to/dokuwiki;
	index doku.php;
	listen 80;
	#Enforce https for logins, admin
	if ($args ~* do=(log|admin|profile)) {
		rewrite ^ https://$host$request_uri? redirect;
	}
	include dokuwiki.conf;
    }
 
    server {
	server_name wiki.host.org;
	root /path/to/dokuwiki;
	index doku.php;
	listen 443 ssl;
	keepalive_requests    10;
	keepalive_timeout     60 60;
	ssl_certificate      /etc/ssl/certs/ssl-cert-snakeoil.pem;
	ssl_certificate_key  /etc/ssl/private/ssl-cert-snakeoil.key;
	#switch back to plain http for normal view
 
	if ($args ~* (do=show|^$)){
		rewrite ^ http://$host$request_uri? redirect;
	}
	include dokuwiki.conf;
    }

В dokuwiki.conf (тот же путь, что и у вашего nginx.conf) вы можете использовать фрагмент из вики nginx, но вам нужно добавить

fastcgi_param HTTPS $php_https;

в ваш fastcgi_params. Этот параметр и map директива в начале обязательны, поскольку Dokuwiki проверяет $_SERVER['HTTPS'] для работы.

Как и в случае с Apache, вам необходимо отключить Securecookie в вашем conf/dokuwiki.php.

HTTPS на основе PHP

Ниже полезно, если вы хотите принудительно использовать https-соединение ВСЕГДА (не только для входа) и не хотите полагаться на Apache или NGINX htaccess или другие специфичные для сервера директивы. Поместите следующие строки в начало файла шаблона в '…lib/tpl/template-name/main.php'

<?php
if ($_SERVER[HTTPS]!="on") {
  //$strURIName=$_SERVER['SERVER_NAME'] . getenv("REQUEST_URI"); 
  // Функция 'getenv' не работает, если ваш API сервера - ASAPI (IIS). 
  // Поэтому постарайтесь использовать не getenv('REMOTE_ADDR'), а $_SERVER["REMOTE_ADDR"].
  $strURIName= $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI'];
  header ("Location: https://$strURIName");
  // Если это не работает для вас и вам нужно устранить неполадки в вашем PHP-коде, 
  // раскомментируйте ниже, чтобы узнать о ваших конкретных переменных сервера 
  /*
  echo "<b>_SERVER Variables from $_SERVER</b><br><br>";
  reset($_SERVER);
  while (list ($key, $val) = each ($_SERVER)) {
  print $key . " = " . $val . "<br>";
  }
  */
}
?>

Спасибо. Это спасло мой день!

Обсуждение

integrate-dokuwiki-to-your-website

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Sep 2023 01:41:44 +0000

Интегрируйте «ДокуВики» на свой сайт

Что?

из вашего PHP-кода возьмите любую страницу из «ДокуВики» и отобразите ее по своему усмотрению ( например, внутри вашего шаблона).
никаких изменений в вашей установке «ДокуВики»
сделал очень мало кода

Как?

Как работает «ДокуВики»: разметка вики читается парсером, который возвращает инструкции. Эти инструкции обрабатываются средством рендеринга для создания HTML- кода.

Для справки, инструкция выглядит так:

Array
(
    [0] => internallink
    [1] => Array
        (
            [0] => java:spring:hello_world
            [1] => Hello World
        )
 
    [2] => 150
)

Вместо того, чтобы повторять один и тот же процесс по каждому запросу пользователя, «ДокуВики» имеет мощную систему многоуровневого кэширования. Используя его, мы можем просто получить кэшированные инструкции и обработать их с помощью специального средства визуализации для создания собственного HTML- кода (со ссылками на наши страницы PHP, а не с URL-адресами DokuWiki).

Пример

Загрузите его здесь.

Иерархия файлов

index.php
doc.php

докувики
включать
- DokuWikiRendererXHTML.php

Индексная страница содержит несколько ссылок на doc.phpфайлы данных из dokuwikiпапки (стандартная установка «Докувики»). DokuWikiRendererXHTML.php — это пользовательский рендерер (переопределяет некоторые методы стандартного HTML- рендерера DokuWiki ).

Как заставить пример работать

doc.php: обновите три переменные в разделе конфигурации.
просмотрите index.php в своем браузере (с тем же базовым URL-адресом, который вы указали в doc.php). Нажмите «Стандартный интерфейс DokuWiki». Просмотрите две перечисленные вики-страницы.
вернитесь к index.php и просмотрите ссылки «Интегрированные вики-страницы».

Подробности

Мы переопределили средство визуализации «Докувики» только для того, чтобы внутренние ссылки вели на страницы нашего веб-сайта, а не на соответствующие страницы установки «Докувики». «ДокуВики» использует URL-адреса для файлов кэша, поэтому вам необходимо сначала просмотреть страницу в «ДокуВики», прежде чем вы сможете увидеть ее через свой собственный PHP-код. Вы заметите это, только если скопируете/переместите установку «ДокуВики» куда-нибудь еще и попытаетесь просмотреть ее страницы с помощью собственного PHP-кода. Незащищено: можно просмотреть любую страницу из вашей установки «ДокуВики». если вам не нужно «Оглавление» в сгенерированном HTML , добавьте его в doc.php разделе init renderer: <code php>$renderer→notoc();</code>

$renderer->notoc();

local-links-with-icons

anonymous@undisclosed.example.com (Anonymous) — Sun, 19 Jan 2025 10:47:55 +0000

Внутренние ссылки со значками

Отредактируйте файл «_links.css» в папке dokuwiki/lib/tpl/dokuwiki/css, изменив описание для «div.dokuwiki a.wikilink1»:

div.dokuwiki a.wikilink1 {
  background: transparent url(images/tocdot2.gif) 0 0.6em no-repeat;
  padding-left:0.4em; 
}

Оригинальный файл links.css

_links.css

/**
 * This file provides styles for all types of links.
 */
 
/*____________ links to wiki pages ____________*/
 
/* existing wikipage */
.dokuwiki a.wikilink1 {
}
/* not existing wikipage */
.dokuwiki a.wikilink2 {
    text-decoration: none;
}
.dokuwiki a.wikilink2:link,
.dokuwiki a.wikilink2:visited {
    border-bottom: 1px dashed;
}
.dokuwiki a.wikilink2:hover,
.dokuwiki a.wikilink2:active,
.dokuwiki a.wikilink2:focus {
    border-bottom-width: 0;
}
 
/* any link to current page */
.dokuwiki span.curid a {
    font-weight: bold;
}
 
/*____________ other link types ____________*/
 
.dokuwiki a.urlextern,
.dokuwiki a.windows,
.dokuwiki a.mail,
.dokuwiki a.mediafile,
.dokuwiki a.interwiki {
    background-size: 1.2em;
    background-repeat: no-repeat;
    background-position: 0 center;
    padding: 0 0 0 1.4em;
}
/* external link */
.dokuwiki a.urlextern {
    background-image: url(../../images/external-link.svg);
}
/* windows share */
.dokuwiki a.windows {
    background-image: url(../../images/unc.svg);
}
/* email link */
.dokuwiki a.mail {
    background-image: url(../../images/email.svg);
}
 
/* icons of the following are set by dokuwiki in lib/exe/css.php */
/* link to some embedded media */
.dokuwiki a.mediafile {
}
/* interwiki link */
.dokuwiki a.interwiki {
}
 
/* RTL corrections; if link icons don't work as expected, remove the following lines */
[dir=rtl] .dokuwiki a.urlextern,
[dir=rtl] .dokuwiki a.windows,
[dir=rtl] .dokuwiki a.mail,
[dir=rtl] .dokuwiki a.interwiki,
[dir=rtl] .dokuwiki a.mediafile {
    background-position: right center;
    padding: 0 18px 0 0;
}

logging

anonymous@undisclosed.example.com (Anonymous) — Sun, 22 Jun 2025 15:14:58 +0000

Статистика в Dokuwiki

Код на этой странице описывает, как Dokuwiki может быть расширен с помощью журнала. Это может быть полезно, если файлы журнала веб-сервера находятся вне диапазона и требуется некоторая статистика об использовании Dokuwiki.

Я опишу две версии. Первая — это решение высокого уровня, которое будет регистрировать доступ к вики-страницам, а также к внутренним и внешним медиа-файлам. Вторая — для «новичков» и будет регистрировать только вики-страницы.

[примечание J.-F. Lalande] Используя информацию и код, предоставленные на этой странице, я создал плагин logstats который генерирует запись в access.log для каждого доступа к странице dokuwiki. Вы можете увидеть подробности и загрузить его на моей странице плагина logstat.

Формат файла журнала

Оба решения будут использовать формат файла журнала NCSA combined или NCSA extended. Этот формат файла журнала очень популярен и часто используется на веб-серверах, таких как apache. Многие генераторы отчетов могут читать этот формат и создавать из него хорошие отчеты. Благодаря этой фантастической поддержке внешних программ Dokuwiki не нуждается в какой-либо встроенной функции отчетности.

Можно использовать следующие генераторы отчетов (это лишь некоторые примеры, список далеко не полный):

AWStats - Хороший генератор отчетов из Франции. Заметки по настройке DokuWiki в Приложении B ниже
Webalizer - Еще один известный генератор отчетов
…

Формат файла журнала состоит из нескольких полей, объединенных в одну строку:

<host> <rfc931> <user> [<timestamp>] "<request>" <error> <filesize> "<referer>" "<agent>"

<host> - IP-адрес клиентского хоста (мы не делаем обратный поиск хоста)
<rfc931> - удаленная идентификация пользователя или «-», если недоступно
<user> - идентификатор аутентифицированного пользователя или «-», если недоступно
<timestamp> - время в формате [01/Dec/2005:22:19:12 +0200]
<request> - Запрошенный протокол, например GET или POST, запрошенная страница и протокол
<error> - код ошибки от сервера, например, 200 (OK) или 404 (файл не найден)
<filesize> - размер страницы вики (только голый текст)
<referer> - страница, с которой пришел пользователь. Эта информация очень зависит от клиента и не всегда доступна. Функция регистрации делает все возможное, чтобы заполнить здесь полезную информацию.
<agent> - идентификационная информация, которую клиентский браузер сообщает о себе

Окончательная статистика

Ultimate statistics будет регистрировать страницы вики, внутренние и внешние медиафайлы. Основная часть кода была помещена в logfile.php. Этот файл имеет размер около 4 Кбайт, и поскольку мне не разрешено загружать файлы в эту вики, я добавил исходный код в конце этой страницы (см. Приложение A).

Давайте посмотрим, что нам нужно для получения максимальной статистической работы.

1. В качестве первого шага скопируйте файл logfile.php в /inc

2. Вторым шагом нам нужно сообщить Dokuwiki, что она должна заботиться о файле журнала. Это делается в функции init_paths() файла /inc/init.php . Эта функция оценивает некоторые имена путей и сохраняет их в массиве $conf[]. Измените функцию init_paths() так, чтобы она выглядела следующим образом:

function init_paths(){
    global $conf;
 
    $paths = array('datadir'   => 'pages',
            'olddir'    => 'attic',
            'mediadir'  => 'media',
            'metadir'   => 'meta',
            'cachedir'  => 'cache',
            'indexdir'  => 'index',
            'lockdir'   => 'locks',
            'tmpdir'    => 'tmp',
            'accesslog' => 'access.log');
 
    foreach($paths as $c => $p){
        if(empty($conf[$c]))  $conf[$c] = $conf['savedir'].'/'.$p;
        $conf[$c]             = init_path($conf[$c]);
        if($c != 'accesslog' && empty($conf[$c]))  nice_die("The $c ('$p') does not exist, isn't accessible or writable.
                You should check your config and permission settings.
                Or maybe you want to <a href=\"install.php\">run the
                installer</a>?");
    }
 
[...]

Dokuwiki теперь проверит, существует ли файл журнала access.log, и только в этом случае путь сохраняется в $conf['accesslog'].

3. Следующий шаг — добавить функцию в inc/template.php для сохранения согласованности API шаблона . Но сначала нам нужно включить inc/logfile.php.

if(!defined('DOKU_INC')) die('meh.');
require_once(DOKU_INC.'inc/logfile.php');
 
[...]
 
/**
 * зарегистрировать эту страницу в файле журнала
 *
 * @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net>
 *
 */ 
function tpl_logfile(){
    global $ID;
 
    logPageAccess(cleanID($ID));
}

4. Обновите ваш любимый шаблон для вызова tpl_logfile(). Лучшее место — строка сразу после вызова tpl_indexerWebBug(). Скорее всего, это находится в конце файла main.php вашего шаблона:

[...]
 
</div>
<div class="no"><?php /* provide DokuWiki housekeeping */ tpl_indexerWebBug()?></div>
<div class="no"><?php /* do the logging stuff */ tpl_logfile()?></div>  <- ADD THIS LINE
</body>
</html>

5. Чтобы иметь возможность регистрировать медиафайлы, нам нужно изменить /lib/exe/fetch.php. Сначала нам нужно снова включить inc/logfile.php. Добавьте оператор include ниже всех остальных, которые уже есть в lib/exe/fetch.php. Функция logMediaAccess() создает запись в журнале и должна быть вставлена после проверки источника медиафайла. Хорошее место — рядом ~~строка 60~~ строка с комментарием «проверка существования файла», непосредственно перед проверкой существования (см. комментарии ниже).

  require_once(DOKU_INC.'inc/logfile.php');
 
  [...]
 
  //регистрировать доступ к мультимедиа 
  logMediaAccess ( $MEDIA ,  $FILE ) ;
 
  //проверка существования файла

6. Вот и все. Теперь ведение журнала должно работать. Остался только один шаг — создать пустой файл журнала /data/access.log. Процедуры файла журнала будут записывать только в уже существующий файл журнала. Если файл /data/access.log не существует, ничего не будет сделано.

Базовая статистика

Базовая статистика означает, что только доступ к странице вики вызовет запись в файл журнала. Если вам также нужна регистрация медиафайлов, прочтите главу Ultimate Statistics.

Для запуска базовой статистики необходимо всего несколько шагов. Первым шагом будет указание DokuWiki, где находится или должен находиться файл журнала. Добавьте следующую строку в ваш local.php :

$conf['logfile'] = './data/access.log';  //location of log file

В качестве второго шага добавьте следующую функцию в inc/template.php:

/**
 * Эта функция записывает информацию о доступе к текущей странице в журнал
 * файл. Он использует комбинированный формат файла журнала, который также используется
 * веб-сервер apache. Целая куча доступных анализаторов логов может быть
 * используется для визуализации журнала.
 *
 * @автор Маттиас Гримм <matthias.grimm@users.sourceforge.net>
 */ 
function tpl_logfile(){
    global $ID;
    global $conf;
 
    $exists = false;
    $page = cleanID($ID);
 
    resolve_pageid('', $page, $exists);
    $page = str_replace(':','/',$page);
    $page = utf8_encodeFN($page);
 
    $host      = $_SERVER['REMOTE_ADDR'];
    $user      = isset($_SERVER['REMOTE_USER']) ? $_SERVER['REMOTE_USER'] : "-";
    $timestamp = date("[d/M/Y:H:i:s O]");
    $method    = isset($_SERVER['REQUEST_METHOD'])  ? $_SERVER['REQUEST_METHOD']  : "";
    $protocol  = isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : "";
    $filesize  = @filesize(wikiFN($ID));
    $status    = $exists ? "200 $filesize" : "404 0";
    $agent     = isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : "";
    $referer   = $_SERVER['PHP_SELF'];
 
    $logline = "$host - $user $timestamp \"$method $page $protocol\" $status \"$referer\" \"$agent\"\n";
    io_saveFile($conf['logfile'], $logline, true);
}

В качестве третьего и последнего шага добавьте следующую строку в main.php вашего любимого шаблона. Строка сразу за вызовом функции индексатора будет вполне подходящей:

<?php tpl_logfile() ?>

Вот и все. Побродите немного по своей вики, а затем посмотрите на файл журнала. Он должен содержать строку для каждой вызванной страницы.

Приложение A

Исходный код logfile.php

logfile.php

<?php
/**
 * Функции ведения журнала DokuWiki
 *
 * @license GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net>
 */
 
  if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../').'/');
  require_once(DOKU_CONF.'dokuwiki.php');
 
/**
 * украсить идентификатор страницы вики для журнала
 *
 * Идентификатор страницы вики будет преобразован в строку имени файла
 * коды utf8 будут закодированы.
 *
 * @param $id идентификатор вики-страницы
 *
 * @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net>
 */ 
function prepareID($path){
    $path = cleanID($path);
    $path = str_replace(':','/',$path);
    $path = utf8_encodeFN($path);
    return $path;
}
 
/**
 * проверяет, существует ли файл, и возвращает соответствующий веб-адрес
 * статус сервера
 *
 * @param $file полный путь к файлу для проверки
 *
 * @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net>
 */ 
function getStatus($file){
    if(@file_exists($file)){
      $size = @filesize($file);
      return "200 $size";
    }else
      return "404 0";
}
 
/**
 * регистрирует доступ к вики-странице
 *
 * @param $id идентификатор страницы вики, включая пространство имен
 *
 * @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net>
 */  
function logPageAccess($id){
    global $ACT;
 
    if ($ACT == 'show'){
      $page = prepareID($id);
 
      $crumbs = breadcrumbs();         // получить последние посещенные страницы 
      $crumbs = array_keys($crumbs);   // получить необработанные идентификаторы страниц  
      array_pop($crumbs);              // пропустить текущую страницу
      $referer = array_pop($crumbs);   // получить предыдущую страницу текущей страницы 
      $referer = ($referer) ? prepareID($referer) : '';
 
      logAccess($page,getStatus(wikiFN($id)),$referer);
    }
}
 
/**
 * регистрирует доступ к медиафайлу (внутренний или внешний)
 *
 * @param $media url или путь к медиа в dokuwiki
 * @param $file полный путь к медиафайлу
 *
 * @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net>
 */ 
function logMediaAccess($media,$file){
    if(!preg_match('#^(https?|ftp)://#i',$media))
      $media = prepareID($media);
 
    logAccess($media,getStatus($file));
}
 
/**
 * создает запись в файле журнала и записывает ее в журнал
 *
 * Эта функция записывает информацию о доступе к текущей странице в журнал
 * файл. Он использует комбинированный формат файла журнала, который также используется
 * веб-сервер apache. Целая куча доступных анализаторов логов может быть
 * используется для визуализации журнала.
 *
 * @param $page имя вызванной страницы
 * @param $status HTTP-код статуса, за которым следует размер файла
 * @param $referer предшественник $page (какая страница ссылается на $page)
 * Если это поле пустое, функция пытается получить
 * реферер с веб-сервера (HTTP_REFERER)
 *
 * @автор Маттиас Гримм <matthias.grimm@users.sourceforge.net>
 *
 * комбинированный формат файла журнала:
 * <хост> <rfc931> <пользователь> [<метка времени>] "<запрос>" <ошибка> <размер файла>
 * "<реферер>" "<агент>"\n
 *
 * <host> IP-адрес клиентского хоста (мы не делаем обратный поиск хоста)
 * <rfc931> удаленная идентификация пользователя или «-», если недоступно
 * <пользователь> идентификатор пользователя или «-», если недоступно
 * <timestamp> время в формате [01/Dec/2005:22:19:12 +0200]
 * <request> Запрошенный протокол, например GET или POST, запрошенная страница
 * и протокол
 * <error> код ошибки от сервера, например, 200 (OK) или 404 (файл
 * не найдено)
 * <filesize> размер страницы вики (только голый текст)
 * <referer> страница, которая вызвала эту. У нас нет этой информации
 * и заполнил имя скрипта dokuwiki.
 * <agent> идентифицирующая информация, которую сообщает клиентский браузер
 * о себе
 */ 
function logAccess($page,$status,$referer=''){
    global $conf;
 
    if (!empty($conf['accesslog'])){
      $host      = $_SERVER['REMOTE_ADDR'];
      $user      = isset($_SERVER['REMOTE_USER']) ? $_SERVER['REMOTE_USER'] : "-";
      $timestamp = date("[d/M/Y:H:i:s O]");
      $method    = isset($_SERVER['REQUEST_METHOD'])  ? $_SERVER['REQUEST_METHOD']  : "";
      $protocol  = isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : "";
      $agent     = isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : "";
 
      if (empty($referer)){
        if(isset($_SERVER['HTTP_REFERER'])){
          $cnt = preg_match('/\?id=((\w+\:*)+)/i',$_SERVER['HTTP_REFERER'], $match);
          if($cnt == 1)
            $referer = prepareID($match[1]);
        }
      }
 
      $logline = "$host - $user $timestamp \"$method $page $protocol\" $status \"$referer\" \"$agent\"\n";
      io_saveFile($conf['accesslog'], $logline, true);
    }
}
 
//Настройка VIM: например: et ts=2 enc=utf-8 :

Приложение B — Конфигурация AWStats

Если вы решили использовать AWStats для обработки своих журналов, то вот несколько советов по параметрам конфигурации, которые дадут вам больше контроля над тем, как отображаются доступы к DokuWiki.

По умолчанию AWStats не отслеживает параметры после «?» в URL . Поэтому все ваши обращения к вики будут отображаться как обращения к одной странице «doku.php». Если вы хотите увидеть, к каким страницам вики осуществляется доступ, вы можете включить отслеживание параметров.

URLWithQuery=1 # Set this to "1" to enable tracking of URL parameters
URLWithQueryWithOnlyFollowingParameters="id media" # Use this to limit which parameters you are interested in.

AWStats позволяет вам создавать настраиваемые отчеты. Вот 3 дополнительных настраиваемых отчета, которые показывают 10 лучших:
- просмотренные страницы вики в порядке убывания популярности
- Файлы wiki-медиа, загруженные в порядке убывания популярности
- поиски, выполненные с использованием поля поиска вики

ПРИМЕЧАНИЕ: Вам придется отредактировать следующие строки в соответствии с вашей установкой:

ExtraSectionCondition* - укажите URL- путь к файлам doku.php и fetch.php
ExtraSectionFirstColumnFormat* — как указано выше
MaxNbOfExtra* — установите количество строк, которое вы хотите включить в отчет

ПРИМЕЧАНИЕ: Результаты имеют следующие ограничения:

DokuWiki иногда переключается на метод POST вместо метода GET. Файлы журналов не содержат параметров для запросов POST и поэтому не будут учитываться в этих отчетах.
Параметр «id=» перегружен — он не всегда представляет собой запрос конкретной страницы.
Если пользователь выполняет поиск, не нажимая <RETURN> или «Поиск», то поиск выполняется с использованием AJAX и не отображается в этих отчетах.

ExtraSectionName1="Wiki Pages"
ExtraSectionCodeFilter1="200 304"
ExtraSectionCondition1="URL,\/doku.php"
ExtraSectionFirstColumnTitle1="Page"
ExtraSectionFirstColumnValues1="QUERY_STRING,id=([^&]+)"
ExtraSectionFirstColumnFormat1="<a href="/doku.php?id=%s">%s</a>"
ExtraSectionStatTypes1=PHBL
ExtraSectionAddAverageRow1=0
ExtraSectionAddSumRow1=1
MaxNbOfExtra1=10
MinHitExtra1=1

ExtraSectionName2="Wiki Media Downloads"
ExtraSectionCodeFilter2="200 304"
ExtraSectionCondition2="URL,\/fetch.php"
ExtraSectionFirstColumnTitle2="Document"
ExtraSectionFirstColumnValues2="QUERY_STRING,media=([^&]+)"
ExtraSectionFirstColumnFormat2="<a href="/lib/exe/fetch.php?media=%s">%s</a>"
ExtraSectionStatTypes2=PHBL
ExtraSectionAddAverageRow2=0
ExtraSectionAddSumRow2=1
MaxNbOfExtra1=10
MinHitExtra1=1

ExtraSectionName3="Wiki Searches"
ExtraSectionCodeFilter3="200 304"
ExtraSectionCondition3="QUERY_STRING,do=search&id=([^&]+)"
ExtraSectionFirstColumnTitle3="Search terms"
ExtraSectionFirstColumnValues3="QUERY_STRING,id=([^&]+)"
ExtraSectionFirstColumnFormat3="<a href="/doku.php?do=search&id=%s" target="_blank">%s</a>"
ExtraSectionStatTypes3=PHBL
ExtraSectionAddAverageRow3=0

Обсуждение

Можно ли сохранять результаты поиска в файле журнала?

Согласен, что было бы очень полезно иметь возможность записывать информацию в файл журнала, а не проверять логи Apache. Dopple 25/08/2009

maintenance

anonymous@undisclosed.example.com (Anonymous) — Sun, 16 Feb 2025 18:29:57 +0000

Обслуживание

Вот несколько советов по автоматизации некоторых повседневных операций по обслуживанию, необходимых или рекомендуемых для DokuWiki.

См. также плагины: cleanup и clearhistory

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

См. раздел «Черный список» о том, как настроить cronjob для поддержания черного списка антиспама в актуальном состоянии.

Скрипт автоматической очистки

Рекомендуется настроить процесс очистки для загруженных DokuWiki. Следующий скрипт оболочки Bash (Unix shell) служит примером. Он удаляет старые ревизии с чердака, служит примером. Он удаляет старые ревизии из cache¹⁾.

cleanup.sh

#!/bin/bash
 
cleanup()
{
    local data_path="$1"        # полный путь к каталогу данных вики 
    local retention_days="$2"   # количество дней, по истечении которых старые файлы должны быть удалены
 
    # удалить файлы старше ${retention_days} дней из attic и media_attic (старые ревизии) 
    find "${data_path}"/{media_,}attic/ -type f -not -name _dummy -mtime +"${retention_days}" -delete
 
    # удалить устаревшие файлы блокировки (файлы, которым 1-2 дня) 
    find "${data_path}"/locks/ -name '*.lock' -type f -mtime +1 -delete
 
    # удалить пустые каталоги
    find "${data_path}"/{attic,cache,index,locks,media,media_attic,media_meta,meta,pages,tmp}/ \
        -mindepth 1 -type d -empty -delete
 
    # удалить файлы старше ${retention_days} дней из кэша 
    if test -n "$(find "${data_path}"/cache/?/ -maxdepth 1 -print -quit &> /dev/null)"
    then
        find "${data_path}"/cache/?/ -type f -not -name _dummy -mtime +"${retention_days}" -delete
    fi
}
 
 
# очистка установок DokuWiki (путь к datadir, количество дней) 
# несколько примеров:
 
cleanup /home/user1/htdocs/doku/data    256
cleanup /home/user2/htdocs/mywiki/data  180
cleanup /var/www/superwiki/data         180

Для автоматического запуска настройте cronjob. Следующий пример вызывает скрипт каждый день через 7 минут после полуночи. Для запуска от имени пользователя без прав root удалите root.

7 0 * * *   root  /full/path/to/cleanup.sh

Обязательно настройте все правильно — вы ведь не хотите удалить не то, не правда ли?

Windows -- warmzip

Скрипт для очистки старых файлов в системах Windows — waRmZip, доступен here on SourceForge. Напишите пакетный файл для его вызова и запланируйте его запуск на каждый день. И как говорит человек: «Обязательно настройте все правильно»' ;-)

Я воспользовался приведенным выше предложением waRmZip и написал этот пакетный файл — возможно, он поможет.

Мой любимый способ запуска заданий cron в Windows — PyCron.

dw-cleanup.bat

@echo off
set waRmZip="c:\Program Files\waRmZip\waRmZip.wsf"
set wikiHome="c:\path\to\htdocs\wiki\data"

rem Переместить файлы attic старше 30 дней в архивное местоположение 
%waRmZip% %wikiHome%\attic /ma:30 /md:%wikiHome%_archive\attic /r /q

rem Параметр: удалить файлы attic старше 30 дней
rem %waRmZip% %wikiHome%\attic /da:30 /dc /r /q

rem Удалить пустые каталоги attic; waRmZip требует флаг /da при использовании 
rem /df, поэтому добавьте фильтр для *.zzz, чтобы /da не удалял никакие файлы 
%waRmZip% %wikiHome%\attic /r /da:31 /df /fo:*.zzz /q

rem Удалить устаревшие файлы блокировки
%waRmZip% %wikiHome%\locks /da:1 /fo:*.lock /r /q

rem Удалить пустые каталоги 
%waRmZip% %wikiHome%\pages /da:365 /df /fo:*.zzz /r /q

Windows -- batch script

Это еще один скрипт командной оболочки Windows для поддержки вашей базы dokuwiki в среде Windows. Скрипт использует бесплатную и открытую утилиту find, которую можно получить черезhttp://gnuwin32.sourceforge.net/

Все пути считываются из файла конфигурации DokuWiki. Файлы, которые нужно удалить, можно показать перед удалением, чтобы предотвратить случайное удаление файлов.

maintain_dokuwiki.cmd

@echo off
setlocal

REM Этот скрипт выполняет некоторые основные функции обслуживания DokuWiki 

REM Авторские права (C) 2012 Питер Мосманс 

REM Эта программа является свободным программным обеспечением: вы можете распространять ее и/или изменять 
REM в соответствии с условиями GNU General Public License, опубликованной 
REM Free Software Foundation, либо версии 3 Лицензии, либо 
REM (по вашему выбору) любой более поздней версии. 

REM Эта программа распространяется в надежде, что она будет полезна, 
REM но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии 
REM ТОВАРНОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ. 
Подробнее см. в REM GNU General Public License. 

REM Вы должны были получить копию GNU General Public License 
REM вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>. 

REM Пожалуйста, свяжитесь со службой поддержки по адресу go-forward.net для вопросов и/или отзывов

 
REM Последнее изменение: 02-05-2012 (Питер Мосманс) 
set NAME=maintain_dokuwiki
set VERSION=0.13

REM путь к файлу конфигурации dokuwiki, заключенный в двойные кавычки 
set DOKUWIKICONFIG="\full\filename\of\your\dokuwiki\conf\local.php"
REM сохранить все файлы, которые моложе DAYSTOKEEP дней 
set DAYSTOKEEP=31
REM установите значение true, если вы хотите отобразить результаты и сделать паузу перед удалением любых файлов 
set SHOWRESULTSFIRST=true
set FIND=c:\tools\find.exe
set TEMPFILE=%TMP%\%NAME%.tmp

REM посмотрите, все ли инструменты присутствуют 
for %%i in (%FIND%) do (
    if not exist %%i (
        echo sorry, could not find %%i - exiting
        echo you can obtain the free GNU tools from gnuwin32.sourceforge.net
        exit /b
    )
)

REM проверяем, можно ли прочитать файл конфигурации dokuwiki 
if not exist %DOKUWIKICONFIG% (
    echo sorry, could not find DokuWiki config at %DOKUWIKICONFIG% - exiting
    exit /b
)

REM извлекаем правильные пути из файла конфигурации 
for /f "usebackq delims=' tokens=2,4" %%i in (%DOKUWIKICONFIG%) do (
    if /i "%%i"=="datadir" set DOCUMENTROOT=%%j
    if /i "%%i"=="olddir" set ATTICDIR=%%j
    if /i "%%i"=="cachedir" set CACHEDIR=%%j
    if /i "%%i"=="lockdir" set LOCKDIR=%%j
)
if "%DOCUMENTROOT%" == "" (
    echo sorry, could not find datadir variable in %DOKUWIKICONFIG%, exiting...
    exit /b
)

REM использовать значения по умолчанию, если пути не указаны 
if /i "%ATTICDIR%" == "" set ATTICDIR=%DOCUMENTROOT%/attic
if /i "%LOCKDIR%" == "" set LOCKDIR=%DOCUMENTROOT%/lock
if /i "%CACHEDIR%" == "" set CACHEDIR=%DOCUMENTROOT%/cache

REM удалить файлы старше DAYSTOKEEP дней из attic 
%FIND% "%ATTICDIR%" -type f -mtime +%DAYSTOKEEP% -print > %TEMPFILE%
REM снять блокировки старше одного дня 
%FIND% "%LOCKDIR%" -name "*.lock" -type f -mtime +1 -print >> %TEMPFILE%
REM удалить файлы кэша старше DAYSTOKEEP 
%FIND% "%CACHEDIR%" -type f -mtime +%DAYSTOKEEP% -print >> %TEMPFILE%

REM показать результаты, если таковые имеются 
for /f "usebackq" %%i in (`%FIND% "%TMP%" -size +1 -name %NAME%.tmp`) do (
    if /i "%SHOWRESULTSFIRST%"=="TRUE" (
        echo files to be deleted:
        type %TEMPFILE%
        pause
    )
    for /f "delims=#" %%i in (%TEMPFILE%) do del "%%i"
)

REM очистить 
del /f /q %TEMPFILE%
 
endlocal

Поддержание чистоты на детской площадке

Чтобы поддерживать чистоту playground и других страниц вики , используйте задание cron, например, каждые 30 минут, которое восстанавливает Playground и другие страницы до их первоначального содержимого.

Пример: восстанавливать игровую площадку каждые 30 минут::

0,30 * * * * cp -f /path/to/savedwiki/data/pages/playground/playground.txt /path/to/dokuwiki/data/pages/playground/

Пример: восстановление всех страниц в пространстве имен «wiki» каждые 30 минут:

0,30 * * * * cp -rf /path/to/savedwiki/data/pages/wiki/ /path/to/dokuwiki/data/pages/wiki/

Проблемы с плагином CAPTCHA

Использование плагина CAPTCHA и обслуживаниярекомендуемого метода для поддержания чистоты игровой площадки может привести к невозможности редактирования игровой площадки.

Если это произошло, проблему можно легко решить, удалив соответствующие файлы Playground в папке meta с помощью следующего задания cron.

Пример: удаляет метафайлы Playground каждые 30 минут:

0,30 * * * * rm -f /path/to/dokuwiki/data/meta/playground/playground.*

Когда cronjob недоступен

Если ваш хостинг не позволяет использовать cronjobs, рассмотрите возможность использования плагин cronojob.

Обсуждение

Не могли бы вы предоставить PHP-версии этих скриптов для использования с плагином cronojob?

Что касается приведенного выше скрипта очистки, который использует время изменения файла (mtime), не будет ли безопаснее использовать временную метку в имени файла, чтобы определить, следует ли удалять файл на чердаке или нет?

С одной стороны, я бы сказал, что это можно сделать, но, конечно, это сложнее в настройке. Для многих установок будет нормально использовать mtime. С другой стороны, некоторые могут захотеть убедиться, что они очищают старые файлы, несмотря ни на что (например, файлы, оставшиеся после сбоя или критической ошибки PHP).

Может ли кто-нибудь добавить соответствующую строку для обслуживания кэша в скрипт Windows waRmZip?

Справляется ли cleanup Plugin со всеми вышеперечисленными задачами? Будет ли он рекомендован вместо запуска этих скриптов?

Это пример PHP-скрипта для очистки старых файлов кэша. Полезно, когда .sh недоступен для запуска.

cleanup.php

<?php 
/* 
 * mrlemonade ~ 
 */ 
function getFilesFromDir($dir) { 
  $files = array(); 
  if ($handle = opendir($dir)) { 
    while (false !== ($file = readdir($handle))) { 
        if ($file != "." && $file != "..") { 
            if(is_dir($dir.'/'.$file)) { 
                $dir2 = $dir.'/'.$file; 
                $files[] = getFilesFromDir($dir2); 
            } 
            else { 
              $files[] = $dir.'/'.$file; 
            } 
        } 
    } 
    closedir($handle); 
  } 
  return array_flat($files); 
} 
function array_flat($array) { 
  foreach($array as $a) { 
    if(is_array($a)) { 
      $tmp = array_merge($tmp, array_flat($a)); 
    } 
    else { 
      $tmp[] = $a; 
    } 
  } 
  return $tmp; 
} 
 
// Определяем папку для очистки 
$captchaFolder = 'data/cache';
// Здесь можно определить, через сколько 
// дней файлы должны быть удалены 
$expire_time = 5; 
// Найти все файлы указанного типа 
foreach (getFilesFromDir($captchaFolder) as $Filename) {
        // Считать время создания файла 
        $FileCreationTime = filectime($Filename);
        // Вычислить возраст файла в секундах
        $FileAge = time() - $FileCreationTime; 
        // Файл старше указанного промежутка времени? 
        if ($FileAge > ($expire_time*60*60*24 )) {
            // Теперь что-нибудь сделаем со старыми файлами... 
            print "The file $Filename is older than $expire_time days \n";
            // Например, удаление файлов: 
            // unlink($Filename); ;
        }
}
echo 'ran';
?>

используйте это на свой страх и риск. — S.C. Yoo 2012/02/10 12:49

Привет, я хотел бы добавить, что это хорошая идея — очищать потерянные метаданные, как вы думаете? Я делаю следующее (в скрипте R):

рекурсивно вывести список всех файлов в каталоге страниц добавьте в этот список столбец «pagename», который снова будет содержать имя файла, но без базового каталога. в имени страницы замените '/' (или '\') на ':' и удалите расширение файла сделать то же самое для мета-каталога + исключить некоторые дополнительные файлы удалить все записи из мета-списка, из которых имя страницы находится в списке страниц удалить все файлы, оставшиеся в мета-списке Конечно, можно было бы добавить ограничение по времени, чтобы метаданные не использовались немедленно.

Clemo 2016/09/23 sometime

¹⁾

Обсуждение обслуживания кэша можно также найти на форуме.

romanize

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:53:42 +0000

Романизация имён файлов

Ключевые слова: UTF-8,romanize, cyrillic, latin, convert, filename

При обновлении с версий, которые ещё не имели функции «romanize», вы столкнетесь с полностью нечитаемой структурой директорий.

Например: %D0%BA%D1%8B%D1%80%D0%B3%D1%8B%D0%B7%D1%81%D1%82%D0%B0%D0%BD.txt — тоже самое, что и «кыргызстан.txt».

Это произошло из-за того, что имена файлов в кодировке UTF-8 подвергаются преобразованию urlencode.

В последних версиях была добавлена опция «романизации» для того, чтобы обойти эту проблему.²⁾

Скрипт, приведённый ниже, конвертирует нечитаемое содержание директории в «романизированные» имена файлов.

Вам необходимо включить файл UTF8.php, который входит в инсталляцию «ДокуВики».

Замечание: этот скрипт не безупречен: например, есть определенные кириллические буквы, которые приведут к вставке символа «'» в имя файла. Все из-за того, что в UTF-8.php транслитерацией буквы 'ъ' является символ «'».

Пожалуйста, проверьте свою структуру статей после преобразования некорректных имен файлов.

Я надеюсь, что это будет полезно кому-то. Любые улучшения приветствуются.

Update: UTF8.php был переписан, код, приводимый ниже, был протестирован с этой³⁾ версией UTF8.php

<?php
 
include("utf8.php"); //to be found in the \inc directory of the default dokuwiki install 
 
/**
 * Copy a file, or recursively copy a folder and its contents, and clean up the filenames according to the dokuwiki UTF-8 
 *
 * @original_author      Aidan Lister <aidan@php.net>
 * @link        http://aidanlister.com/repos/v/function.copyr.php
 * @param       string   $source    Source path
 * @param       string   $dest      Destination path
 * @return      bool     Returns TRUE on success, FALSE on failure
 */
function copyr($source, $dest)
{
	$dest2=cleanID($dest);
	echo $source."->".$dest." ->$dest2<br/>\n";
    // Simple copy for a file
    if (is_file($source)) {
        return copy($source, $dest2);
    }
 
    // Make destination directory
    if (!is_dir($dest)) {
        mkdir($dest2);
 
	}
 
    // Loop through the folder
    $dir = dir($source);
    while (false !== $entry = $dir->read()) {
        // Skip pointers
        if ($entry == '.' || $entry == '..') {
            continue;
        }
 
        // Deep copy directories
        if ($dest !== "$source/$entry") {
            copyr("$source/$entry", "$dest/$entry");
        }
    }
 
    // Clean up
    $dir->close();
    return true;
}
 
copyr("/dokuwiki/data/pages/","/dokuwiki/data/pagesnew/");
 
function cleanID($id,$ascii=false){
  $id = trim(urldecode($id));
  $id = utf8_strtolower($id);
  $id = utf8_romanize($id);
  utf8_deaccent($id,-1);
  $id = preg_replace('#\'+#','_',$id);
  return($id);
}
 
 
?>

²⁾

См. подробнее в «deaccent» и romanization

³⁾

переводчик: непонятно, какой

svg_icons

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 15:38:16 +0000

Пользовательские значки SVG

Редакторы

Вы можете создать свои собственные многоцветные значки SVG для своей веб-страницы «ДокуВики», используя любой редактор путей SVG по вашему выбору. Существуют бесплатные онлайн-версии и устанавливаемые. Вот хорошее введение и обзор, где я нашел несколько первых подсказок:

https://css-tricks.com/tools-visualize-edit-svg-paths-kinda/

Я рекомендую следующий онлайн-генератор/редактор путей SVG для создания новых значков:

https://yqnn.github.io/svg-path-editor/

Example

В целом SVG-файл значка может выглядеть следующим простым примером:

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
<path fill="red" d="M 4 4 L 4 20 L 20 20 L 20 4 Z"/>
<path fill="white" d="M 5 5 L 5 15 L 15 15 L 15 5 Z"/>
<path fill="red" d="M 8 8 L 8 12 L 12 12 L 12 8 Z"/>
<path fill="transparent" stroke="blue" stroke-width="1px" d="M 7 8 L 10 13 L 14 7"/>
</svg>

Пути в этом контексте означают непрерывную последовательность всех команд пути (координат) из всех атрибутов d элемента пути из одного файла SVG (здесь из примера SVG выше):

M 4 4 L 4 20 L 20 20 L 20 4 Z
M 5 5 L 5 15 L 15 15 L 15 5 Z
M 8 8 L 8 12 L 12 12 L 12 8 Z
M 7 8 L 10 13 L 14 7

Из координат в приведенном выше примере легко увидеть, что первые три пути представляют собой квадраты, вложенные друг в друга. Четвертый элемент представляет собой штрих (многострочный) и поэтому намеренно не закрывается буквой Z. Как показывает этот пример, каждая строка пути в последовательности путей представляет собой один графический элемент.

Рабочий процесс

Редактирование пути

Что в основном понимают редакторы путей SVG, так это непрерывная последовательность строк пути. Итак, на основе приведенного выше примера SVG-файла приведенная выше последовательность строк пути — это то, что вы можете вставить в редактор по вашему выбору. Если вы загружаете файлы SVG с намерением изменить их, вам, возможно, придется разделить, очистить, отсортировать и закрыть строки открытого пути, прежде чем их можно будет редактировать каким-либо удобным способом. Некоторая очистка может выполняться редактором путей автоматически при импорте строк пути. Однако, чтобы иметь возможность эффективно работать со своим значком, рекомендуется отделять каждый отдельный графический элемент вашего значка как новую строку пути, начинающуюся с буквы M, и закрывать каждую строку пути буквой Z, чтобы отслеживать их. начала и окончания графического элемента во всей последовательности путей в вашем редакторе. (Единственным исключением являются открытые штрихи, подобные последнему в примере.) Для всех вариантов создания контуров и манипуляций с ними существует множество онлайн-руководств и видеороликов на YouTube.

После редактирования путей вам необходимо преобразовать их обратно в формат файла SVG. Хорошей практикой является размещение каждого элемента пути на новой строке, как в примере выше. Сохраните файл на диске, чтобы иметь возможность просматривать значок SVG в браузере.

Редактирование SVG

Вы можете поиграть с примером SVG, приведенным выше. Просто вставьте код в текстовый файл, назовите его test-icon.svg и откройте его в браузере по умолчанию двойным щелчком мыши. Как указано выше, пример SVG состоит из трех фигур, которые представляют собой замкнутые контуры (или, другими словами: области), которые могут быть заполнены (залиты) цветом. Открытому пути (многострочному) можно задать толщину линии (ширину обводки) и цвет обводки, как показано в примере файла SVG выше. К сожалению, редакторы путей не отображают эти цвета. Однако при отображении в браузере все эти пути накладываются друг на друга в том порядке, в котором они перечислены в SVG-файле (последний сверху), поэтому последовательный порядок здесь имеет значение! Вы можете поиграть с примером, изменив порядок путей в файле и обновив браузер, чтобы увидеть результат.

SVG-стиль

Если вы оставите цвет заливки для элементов пути необъявленным, «ДокуВики» может установить определенный цвет, например, для конкретного меню. Но когда вы объявляете цвет заливки, цвета «ДокуВики» по умолчанию будут переопределены. С другой стороны, если ни «ДокуВики», ни вы не определите цвет, по умолчанию он будет черным (браузером), что не всегда красиво. Таким образом, в большинстве случаев вам будет лучше объявить цвета путей для каждого пути в соответствии с вашими дизайнерскими идеями. Вы также можете объявить цвета, используя обозначение RGB, здесь для красного:

fill="rgb(255,0,0)"

Если на вашем значке есть белый символ на цветном фоне, рекомендуется объявить белый цвет заливки или обводки для пути этого переднего символа. Потому что, если вы оставите его бесцветным или прозрачным, белый цвет фона веб-страницы может не просвечивать ни при каких обстоятельствах (например, в темном режиме браузера). Итак, опять же, в большинстве случаев вам лучше явно объявить белый цвет вашего выдающегося символа.

Также вы можете дополнительно стилизовать свой SVG в целом, вставив атрибут стиля, например:

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="transform: rotate(90deg) scale(0.5) translate(-10%, -10%);">

Просто убедитесь, что ваш значок не выскальзывает из окна просмотра, иначе он будет невидим (переполнение скрыто).

Примечание. Конечно, все это можно сделать и с помощью Inkscape, который имеет открытый исходный код, но это более сложный рабочий процесс со своими плюсами и минусами. (самый большой плюс — функция преобразования контура в траекторию для автоматического создания траектории)

References

— Chris75 2023-03-17

timezone

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Sep 2023 01:25:27 +0000

Настройка временной зоны

Редактирование файла настроек «Докувики»

Чтобы установить корректную временную зону, отредактируйте отдельный файл conf/local.protected.php (он защищён от затирания при обновлении версий вики-движка) и добавьте следующую строку:

date_default_timezone_set("GMT");

Обратите внимание на наличие в файле тега <?php. Замените GMT на свою временную зону. Например, если вы живете в Дании: DK +5540+01235 Europe/Copenhagen, вам нужно заменить GMT на Europe/Copenhagen, для Москвы — Europe/Moscow.

ВНИМАНИЕ: Это может вызвать сбой в работе RSS-фида, при котором он при сдвиге времени на X часов на восток будет флудить обновления каждые <заданная опция> минут X часов подряд, а при сдвиге на запад они не будут считаться свежими сразу после появления.

Для поправки времени на линукс-хостингах есть вариант, затираемый обновлением движка. Откройте файл /inc/init.php, сделайте поиск строки «date_default_timezone_set» (в билде Greebo – строка 93), отредактируйте. Если одинарные кавычки вызывают проблемы – используйте двойные. Например, для Индии:

date_default_timezone_set('Asia/Kolkata');

Редактирование файла настроек PHP

Можно отредактировать файл php.ini, в Убунту он лежит в /etc/php5/fpm/php.ini. Раскомментируйте строку ;date.timezone = , поставьте своё время.

date.timezone = America/Chicago

И перезапустите PHP.

/etc/init.d/php5-fpm reload

Часовой пояс для читателей

Я⁴⁾ использую вот такой юзерскрипт для моего часового пояса UTC+10 (смотреть переменную «shift»), и оставил ссылку на своём сайте для читателей https://greasyfork.org/ru/scripts/384537-comicslate-timefix

Было бы неплохо сделать плагин для запроса часового пояса в профиле пользователя и хранения этого параметра в куки.

⁴⁾

Dr-Yukon

tips

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 23:00:17 +0000

Tips and Tricks for DokuWiki

This is the place to collect all your Tips and Tricks for DokuWiki Usage.

Steps for reorganization:

Add a description to each page, and categorize within this page. Almost done.
Review external links to remove broken ones, maybe integrate external link to have all content on dokuwiki.org
If possible please rewrite content, and remove old things.

NOTE to translators: When updating your tips page, please use the index button to see what pages are within your locale :tips namespace. And please do include them into the tips page. Thank you.

Usage Tips

Link	Short Description
TailorWikiRules	Best-practices to follow after installing DokuWiki
Syncing with Unison	Sync two wikis using unison
timezone	Set the server's Timezone
mailconfig	Tips on making mail work
commonlogin	Sharing authentication data between wikis on the same server
Displaying blank rows in tables	Displaying blank rows in tables
Good Style	Hints on how to have good styles on DokuWiki
upgrading_old_versions	How to upgrade from old DokuWiki (2005-*)
ShowMediaFromExternalUpload	How to make files uploaded by other ways than mediamanager to appear

Extending the Syntax

Most of these tips need to be adjusted for the new Parser and will not work out of the box. They may be better implemented by using the new plugin system though.

Link	Short Description
magnet links	Show DC++ magnet links as external
links-to-dokuwiki-commands	make links to «DokuWiki actions» (?do=) from within your wiki content, aka. Action Modes, aka. Action Links (in general, URL tags)
tex_howto	This patch (to 2005-05-07 version) add AMSLaTeX mathematical expression support to DokuWiki

Extending Layout and Styling

Some of these tips may be implemented better by using the new template mechanism. You are encouraged to rewrite them accordingly.

Link	Short Description
Top Bar	Add a topbar like on dokuwiki.org
CustomQuoting	Change the style of Quoting
format_user	Using CN from client certificate when displaying username
Disabling link icons	Disables interwiki and non-wiki link icons
Descriptions in RSS aggregator	Add the beginning of every RSS article in the list
Code CSS	CSS for use with Syntax Highlighting
geshi_style_builder	Geshi Style builder
XHTML5	How to switch to XHTML 5
XHTML Strict	How to switch to XHTML 1.0 Strict
Toc use position fixed	When the user scrolls the page, the TOC does not scroll with it, the TOC is fixed.
numbered headings	Numbered headings per CSS only
back to top	back to top before every header
Local links with icons	Local links with icons
Custom SVG icons	Create your custom multi-color SVG icons for your DokuWiki
image-in-the-upper-right-corner	replace top right DokuWiki logo by your own
code-in-ordered-lists	Including Code in Ordered Lists
tableswithrowspans2	Tables with Rowspan Support
Tables with Rowspan	Another way of providing Rowspan support in tables.
rowspansfix	Yet another way to make rowspan possible
rowspansfix2	Yet another way to make rowspan possible
Adjust iframe heights	An additional JavaScript for the iframe plugin to make iframes as high as needed for their content
Using CSS to Style Headers	General tips, case uses and structure info for styling headers with CSS.
Display the changes for each entry in the recent list	Display a diff of the last and the current version for each entry in the recent list]]
printpreview	Preview of the wiki body; Usage for printing or fullscreen-mode
double-click-to-edit	Double Click to Open a Section Edit (improved)
Simple Columns	Implementation of columns without plugins
Button Align	How to align a <button> element?
Additional InterWiki Shortcuts	Share Your InterWiki Shortcuts
Hyphenations within headings and link texts (sorry, German only )	Hyphenations within headings and link texts (German: Worttrennungen innerhalb von Überschriften und Linktexten)

Adding new Functionality

Link	Short Description
Auto Subscribe a Mailinglist	Auto Subscribe a user to a mailinglist after registration
Better Email Notifications	Receive HTML-formatted email notifications for page changes
Clean Notification Scheme	Clarify notification scheme: namespace subscribers on new page, page subscribers on update
IP-based ACLs	Assign access rights based on IP or network of the connecting client.
BrowserLanguageDetection	Change the UI language automatically
transliteration	Transliterate Cyrillic texts to Latin
PDF Export	PDF export using html2ps and pstopdf
Print View Button	make use of ?do=export_html
tpl_button for print view	Adds an tpl_button for print_view
User Link	use an extra wiki-page for users
.htaccess authentication	Use .htaccess authentication instead of the login form
.htaccess authentication 2	As above with support for UserManager
HTTP-Auth Passthru	Adding http-auth-functionality to your existing ACL-setup
Chained Authentication	Use a sequence of authentication backends (e.g. LDAP then plain )
StickyExportHtml	Make do=export_html «sticky» for HTML-only browsing
Html only view	Similar to previous. uses .htaccess rewrite for that
discussion	Creates a link or button in your template that leads to a separate discussion-page (like e.g. Wikipedia does provide)
safely include php code	Allow PHP code to be included in pages created by superuser only
Page Statistics	Add page and media file logging to DokuWiki
Tiny Page Logging	Add simple logging to DokuWiki
NLS	Adding unofficial National Language Support (NLS) for DokuWiki
Summary Enforcement	Require the user to enter a summary (or check minor edit)
ToolbarButton	How to add your own button to the toolbar
homepages	Autocreate user homepages when add/modify user accounts
wordcounter	Add a word-/charcounter to the edit form
mediamanager and filesize	Append the size of the mediamanager selected file to the wikilink
media_attached	media upload is attached to each page
template_chooser	A simple dropdown box in editmode allows you to paste content from a template into the current document
login_instead_of_forbidden	Show the login form when accessing a restricted page
display_acls	Display ACLs in page footer
action_menu	Action menu like in MoinMoin Wiki
export_html	Export multiple pages to HTML
newssystem	A News System. Based on this a plugin was developed: a NEWS System.
subscription	Prevent Email Of Changes to Subscribed Author
phashLogin	Allows «GET» login with a phash password. Useful with RSS readers for example.
Integrate TinyURL	Automatically create a short URL for every page
LDAP and usemanager	`ldap.class.php` modification so that the `usermanager` plugin can display the LDAP users
usermanager and chained auth	Manage each authentication method used by the chained method through the `usermanager`
Filter Recent Changes	Allows you to filter the list of 'Recent Changes' by username (for version 2008-05-05)
Filter Recent Changes	Allows you to filter the list of 'Recent Changes' by username (for version 2009-02-14)
Separate Admin Login	Use a special admin login, which cannot read or edit pages
User Pages	Give everyone AUTH_EDIT on a page within a special namespace, where that page is their name
ClickNShow	Hide/Show Headers clicking on them
Minor Edit by default	Set the «Minor Edit» check mark by default
viewcounter	Adds a simple pageview counter
Make a book	How to make a book with DokuWiki
Namespace Clouds	DokuWiki Cloud Plugin Namespace Discrimination Patch
Copy Section Link	An easy way to copy each section link (with JavaScript)
pageaccueil	Creates a home page that lists categories of wiki to create a new page in the category chosen. Also allows to Create a new category.
gallery	Generate a gallery from images in a namespace, can create and save thumbnails

Integration with Other Software

Content Management Systems and Forums

Link	Short Description
Mambo CMS	How to integrate DokuWiki with Mambo CMS (Spanish)
Joomla Bridge (german)	~~Bridge (authorization module) for using Joomla users in DokuWiki (Also available for Joomla 1.5)~~(doesn't exist anymore)
Joomla Integration	~~Full User Integration of DokuWiki and Joomla with no iframes! new ;-)~~ (doesn't exist anymore)
Drupal	Authentication backend will enable your DokuWiki to authenticate using the Drupal database.
BLOG:CMS	BLOG:CMS integrates DokuWiki with Weblog, Forum and Gallery in one package
TextMate Bundle	Edit pages inside Textmate
Absolut Engine	DokuWiki bridging module has been created to allow seamless integration of DokuWiki into Absolut Engine CMS.
glFusion CMS	DokuWiki Integration Plugin that allows seamless integration of DokuWiki into glFusion.

Forum Systems only

Link	Short Description
phpBB	How to integrate DokuWiki with phpBB's authentication
phpBB 3.0.x	How to integrate DokuWiki with phpBB3s authentication
Invision Power Board IPB 2.x	How to integrate DokuWiki with IPB 2.x authentification
Integrate with SMF	SMF (Simple Machines Forum) Integration
~~Vanilla~~ (Error 404)	Lets Vanilla take care of all the user management, including sessions

Bug Trackers

Link	Short Description
GForge	A plugin for using DokuWiki in GForge
Mantis Integration	How to integrate DokuWiki with Mantis Bugtracker
Flyspray	Flyspray Authentication Integration
Eventum Integration	How to integrate DokuWiki with Eventum Issue Tracker
eventum	Eventum link plugin
Trac	A very dirty way to force Trac and DokuWiki to interact with each other.

Others

Link	Short Description
Synchronise with Tomboy	How to synchronize Tomboy with DokuWiki
Integrate DokuWiki to your website	As read-only pages
Edit DokuWiki with text editors using FUSE and Python	Untested and potentially buggy.
Researchr	Framework for integrating DokuWiki with BibDesk and Skim for academic note taking and citation management

Interacting scripts and tools

Link	Short Description
DokuWiki Setup	Easy/automatic installation/upgrade - also fixing safe-mode issues
Maintenance	Cronjobs to keep your wiki clean
Backup Script	A small shellscript to backup your wiki data and media, including rotation.
BackupToS3	A small ruby script to backup your wiki to Amazon's data storage system S3.
UpgradeScript	A small script to make DokuWiki updates simpler
Weblog bookmarklet	A JavaScript/PHP combination to post in DokuWiki like regular weblogs
imap2wiki	A small PHP script to give users the opportunity to post by email
DokuVimKi	VIM Plugin that allows editing of wiki pages over XML-RPC + Syntax highlighting for DokuWiki syntax
vimkeys	Key Bindings for [G]Vim
fixperms.php	make webserver created files writable by everyone
mail2page	create pages and upload media by email
romanize	romanize files in datadir
DokuWiki2HtmlHelp	Converts a DokuWiki website into a Compiled HTML Help file (.chm) complete with table of contents and index
jEdit	An edit mode for jEdit that does syntax highlighting for headlines, character formats, lists and links
CLI	DokuWiki command line utilities
recreate wiki change log	How to recreate your wiki change log from individual page change logs
readINIfile	How to solve problem with parse_ini_file disabled
fixmtime	Fix modification times based on timestamps (to avoid the `external edit` syndrome)
clean_acl	Clean up non-existing users and pages in the ACL
Clean Media Directory	A little Perl script to clean up orphaned files in the Media-Directory
Logging in to retrieve pages with cURL	Quick howto on retrieving pages that require logging in with curl.
Extract external links	A small PHP script to extract all external links (with surrounding context) from the wiki
Add an Autolink page	A small Perl Script to (re)builds link on chosen words each nights
Automatic build reports	A bash script that compiles/builds a project and reports the result to the wiki
GourceDoku	Picture of the edition of a wiki with Gource
topcontributors	A shell snippet to create a list of the top contributors to the wiki
locateorphanmedia	How to get a listing of all orphaned media ie.: media files that are not linked to in your wiki
Page Annotate	A script to give you idea who edited which line in page. Uses git as a tool to do the trick
Mysql For All	An off-wiki webpage script to provide users the ability to generate mysql queries for use in wiki plugins. Users do not need to know the database structure or mysql syntax.
Dokuwiki orphans	Help you find pages with no links towards them and links to non existant pages in order to keep your Wiki clean.

Importing from External Sources

Wikis

Source Wiki	Description
ChuWiki	A Python script for ChuWiki conversion
ErfurtWiki	A PHP script for ewiki (ErfurtWiki) conversion
JSPWiki	A plugin to import JSPWiki pages
JSPWiki (again)	A pair of scripts to convert a directory of JSPWiki pages
MediaWiki	Converts MediaWiki to DokuWiki
MoinMoin	Python and PHP scripts for MoinMoin conversion.
Perspective	A python script, must be run from Windows
TikiWiki	A PHP script for TikiWiki conversion.
trac	A PHP script for trac's wiki conversion
TWiki	A TWiki to DokuWiki conversion script
Wakka Wiki	A Perl script for Wakka Wiki conversion
Zwiki	A Perl script for Zwiki conversion
docpdf2dokuwiki	A Perl script for importing pdf and doc
Atlassian Confluence	A Perl script for Atlassian Confluence conversion

Other

Link	Description
uploadcodedir	Uploading a directory of code to DokuWiki
table_editing	How to import your data into tables
Wikemail	a script to import email into DokuWiki
OpenOffice Macro	converts an OpenOffice document to DokuWiki format
OpenOffice v2 Macro	converts an OpenOffice document to DokuWiki format, adapted for OOo v2
OpenOfficeMacro	both of the above macros do not convert embedded pictures - this one does
Writer2Dokuwiki	converts an OpenOffice document to DokuWiki format (doesnt fully support lists)
Writer2Dokuwiki (IT-Bayer's version) (in German)	converts an OpenOffice document to DokuWiki format
Calc2Dokuwiki	Exports selected ranges of cells from OpenOffice.org Calc into tables formatted in DokuWiki code. Tool available as an extension (OOo 2.1.x) and a macro (OOo 1.x-2.x)
HTMLtoWiki	How to convert HTML to DokuWiki syntax
Excel to DokuWiki converter	This makro based tool contains parameters on first worksheet to allow the user some customization. Paste your table into another worksheet, select the cells as usual and run the makro to Export it as DW Syntax including styling. Information also available here within DokuWiki at: Excel Macro
csv2dwt	A script that converts Comma Separated Values (CSV) to DokuWiki's Table format (DWT)
csv2dokuwiki	Converts CSV input (tab separated) into DokuWiki's table syntax (in Java)
xls2wiki	A script that converts XLS copied data to DokuWiki's Table format (DWT) and vice versa
doc to wiki syntax	Convert folders with Ms Word Doc files to DokuWiki Syntax
Word to Dokuwiki converter	Here you can download the latest Version of this Doc containing the makro to Export it as DW Syntax. Some Information provided here within the DokuWiki at word makro. Former versions provided by Tania Hew ⇒ Word to DokuWiki Converter improves upon the two macros above as it is a Word template that allows one to click a button in MS Word to convert a Word document, including images, to DokuWiki format (see Portfolio section on website)
Word Macro adaptation	converts an MS Word document to DokuWiki format - improved conversion (for English Word) plus adaptation for German Word
word2wiki	Convert Microsoft Word document content to Wiki markup
google sheets macro	Google Apps Script for exporting a selected cell range to DokuWiki

Miscellaneous

Link	Description
blacklist_test	This little script helps to check a text against the blacklist
blogging	This page describes the steps necessary to get you started with blogging in DokuWiki
bookmarklets	JavaScript based wiki page editing helpers
default text search	Add default text for the search box
disabled_functions	Patch if your webhost doesn't support glob or readfile
DwExport	DokuWiki export to static HTML pages including images and CSS formatting. ⇒ http://sourceforge.net/projects/dwexport/ Only v0.2
farm	How to make DokuWiki a wiki farm
htdigestauth	Setting up htdigest user identification
simplegooglesearch	Replace DokuWiki internal search form with Google search
spell_checker_713	Aspell Personal Wordlists and Release 2005-07-13 (seems old)
svg.php	This is a plugin to DokuWiki to allow collaborative generation of SVG images. (Make it a plugin if possible/useful)
utf8update	DokuWiki UTF8 conversion
export2twiki	Convert DokuWiki syntax into twiki format for exporting
phpwithgd	This page describes how to solve issues caused by missing gdlib support in PHP

How To

No plugin or modifications needed.

Link	Description
weather	Show weather info from https://wttr.in/