Ищете пакет для вики-стиля, автономный, версия-контроль - "безопасный" пакет документации

Моя команда и я обнаружили, что документирование нашего проекта (платформы разработки w/API) с помощью wiki полезно и полезно пользователям. Из-за некоторых организационных вопросов мы вынуждены делать многосайтовые разработки без подключения к сети. Мы переключились на DVCS (Mercurial) и имели большой успех в этом. Документация wiki оказывается проблемой, поскольку центральный сайт настроен с помощью MediaWiki. Пользователи, находящиеся за пределами площадки, не могут получить доступ к вики или редактировать их.

Есть ли какой-либо вид wiki-стиля, который не требует сервера/базы данных и будет использоваться в среде DVCS?

Обновление: должно быть открытым и кросс-платформенным

Ответ 1

Закончилось писать мою собственную систему, используя python, cherrpy и mercurial. Возможно, однажды это закончится открытым исходным кодом. Спасибо за все предложения.

Ответ 2

Я могу порекомендовать TiddlyWiki. Он не нуждается ни в каких веб-серверах, только в браузере, хранит всю документацию Wiki на одной странице HTML. Это можно легко распространять через Mercurial.

Изменить: Проверить эту страницу, в нем обсуждается, как использовать TiddlyWiki с DVCS. Это связано с использованием расширения, получившего название SynchroTiddly.

Ответ 3

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

Ответ 4

ikiwiki: http://ikiwiki.info/ хранит информацию непосредственно в VCS (она поддерживает mercurial как backend).

Ответ 5

http://zim-wiki.org/
Это вики рабочего стола (редактирование WYSIWYG, хотя и не очень сложное форматирование), которое хранит все в текстовых файлах. Это означает, что вы можете хранить файлы в управлении версиями и иметь дружеское редактирование.

У него даже встроенная поддержка Bazaar UPDATE: также Git, Mercurial и Fossil.

^{[Я знаю, поздно, чтобы вечеринка - писать для других, читающих этот вопрос...]}

Ответ 6

Возможно, вам стоит взглянуть на автогенерирование документации из источника. Таким образом, документация будет автоматически контролироваться версиями.

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

Ответ 7

Посмотрите Fossil, это DVCS, который содержит встроенную систему вики и отслеживания ошибок. Это может быть именно то, что вы ищете. Прочитайте сайт, есть встроенный веб-сервер. Вы можете использовать CGI script, чтобы открыть соединение с людьми (ископаемый сайт - это ископаемый DVCS). После его использования вы также можете переместить свой код на него. Он имеет открытый исходный код и имеет кросс-платформенные сборки.

Ответ 8

http://hatta-wiki.org/ - это вики, работающие в репозитории Mercurial.

Интересно отметить, как он обрабатывает конфликты: одновременные изменения беззвучно сливаются при фиксации, даже если они конфликтуют и совершаются с маркерами конфликтов! Это нормально, потому что:

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

Это соглашение мотивирует вас снова редактировать, чтобы немедленно разрешить конфликт, но не заставляет вас.

Ответ 9

Github gollum работает с открытым исходным кодом, git, использует многие популярные синтаксисы. Но наиболее важной точкой продаж, конечно, является то, что она встроена в github.

Bitbucket аналогичным образом имеет виртуализацию, основанную на меркуриализации. Не уверен, что код является открытым исходным кодом (т.е. Вы можете редактировать текст в автономном режиме, но не уверен, что видите его визуализированный).

Ответ 10

MoinMoin поддерживает сохранение ваших страниц в репозитории Mercurial: http://moinmo.in/Storage2009/HelpOnStorageConfiguration#Mercurial_Backend_.28hg.29

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

Ответ 11

Если вам нужна отличная платформа с открытым исходным кодом для управления знаниями, которая может включать в себя объекты знаний на основе видео, вики, рабочий процесс и множество веб-сервисов сообщества, ознакомьтесь с RuleSphere.com. Они работают над некоторыми действительно классными KM и вики и видеокомпонентами.

Они помогли нам понять преимущества работы с открытой платформой, а не автономной вики, чтобы иметь долгосрочную стратегию, чтобы перейти от управления знаниями ко многим другим потребностям, которые наша маленькая фирма хочет решить в следующем году, Теперь мы настроены на то, чтобы выбрать платформу для совместной работы, с которой мы можем расти.

Итог: существует более 100 автономных wiki-платформ, но их ограничения намного превосходят возможности расширяемости и интеграции. Не забудьте взглянуть на "большую картинку" и не задумывайтесь о платформе с открытым исходным кодом, предназначенной для служб Web 2.0, гибкой технологии и совместной работы. Вы будете рады, что сделали!