Разворачиваем Mediawiki на Debian (это очень просто) / Хабр

Если вам нужна своя Вики, но не знаете с чего начать — добро пожаловать. В Linux я новичок, этим мой степ-бай-степ будет особенно полезен. Рассматривается:

1. установка Debian
2. стэка LAMP
3. запуск на этой основе Вики на популярном движке Mediawiki

Выбор дистрибутивов

• ОС – выбираю Debian. Не знаю почему. Конкретнее — debian-10.2.0-amd64-netinst.iso. Дистрибутив, конечно, всегда стоит брать последний из стабильных, ищите на debian.org.
• Mediawiki — потому что этот проект хорошо поддерживается по сей день. Я присматривался к DokuWiki, но последний дистрибутив датируется 2018м годом, а мануалы явно не рассчитаны на новичков.
• Apache, MariaDB и php73 – как рекомендуется Mediawiki.

Памятка для тех, кто совсем не очень хорошо знаком с Linux

1. Linux и всё, что на нём работает, очень чувствительно к регистру.
2. Никто не запрещает вам работать под root, но лучшая практика – подключаться к вашему серверу под неадминистративной записью и повышать, при необходимости, права командой su. Выполнив действия (например, завершив установку), откажитесь от повышенных прав командой exit.
3. Если иное не указано явно, когда я перечисляю команды, предполагается, что мы подключены по ssh и уже выполнили команду su для повышения прав.
4. В качестве клиента ssh использую PuTTY. И вам советую.

Оборудование

• вообще это не имеет никакого значения. Это может быть виртуалка, может быть железка.
  Если у вас совсем мало ресурсов, ознакомьтесь с Installation requirements.

Установка ОС Debian

Целевая аудитория мана – новички в Linux, вроде меня, поэтому опишу установку, даже пошагово. В ней мало принципиально важных настроек, поэтому можете действовать по принципу «Далее»-«Далее», только не забудьте включить в компонентах сервер SSH, если планируете управлять этим сервером удалённо.

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

Графическая установка. Language, Location, Keymap, Network

Выбираю графическую установку.

Язык установки – English

Location – Russian Federation (other – Europe – Russian Federation)

Locales – оставляю United States

Keymap to use – American English

Сеть

В большинстве случаев, как и в моём, в сети есть DHCP-сервер, поэтому настраивать сеть вручную не придётся.

Hostname for this system.

На ваше усмотрение, я указываю wiki02. Совет: воздержитесь от того, чтобы называть узел просто wiki или mediawiki – это даст вам возможность править нужные конфиги методом замены текста. Может это никогда и не понадобится, но может.

Domain name

Укажите принятый в вашей сети DNS-суффикс.

Users, Clock, Partitions

Пользователи и пароли. Root password

User for non-administrative activities

• Full name of the user – снова на ваше усмотрение, я назвал aslan. Если вас коробит имя, написанное с прописной, пишите с заглавной, только не забывайте что регистр важен почти везде, где вы будете писать команды, скрипты, пути etc.
  
• Username для этого пользователя – я использовал тот же aslan
  
• Задаём пароль для созданного пользователя
  

Часы

Часовой пояс — Moscow

Разделы дисков

• Partitioning method – Guided – use entire disk
  
• Select disk to partition – у меня он один
  
• Partitioning scheme – All files in one partition, как и рекомендовано
  
• Finish partitioning and write changes to disk
  
• Write changes to disks – Yes
  

Package manager, HTTP Proxy, Usage Survey, Software Selection

Configure the package manager

• Scan another CD or DVD – мой выбор No
  
• Debian archive mirror country – Russian Federation
  
• Debian archive mirror – deb. debian.org
  

HTTP proxy

Прокси-сервер у меня не используется, оставляю пустым

Configuring popularity-contest

Participate in the package usage survey – лично я в этом не заинтересован.

Software selection

Choose software to install: меня интересуют только сервер SSH и стандартные системные утилиты. Может и утилиты не нужны… но раз стандартные, пусть будут.

GRUB, Finish, Проверка обновлений, Контрольная точка

Install the GRUB

• Install the GRUB boot loader to the master boot record? – мне подходит, Yes.
  
• Device for boot loader installation – выбираю единственный в списке (не Enter device manually)
  

Finish the installation

Создаю контрольную точку «Установлен Debian»

Шаг не обязательный, все, кто уверен в своих силах, или у кого много свободного времени, могут его пропустить как минимум до установки LAMP (PHP, MariaDB и Apache). Я осторожен, и сделаю снапшот уже на этом этапе.

Установка и настройка LAMP Stack

Предполагается, что мы всё ещё подключены по SSH и выполнили команду su. Выполняем описанную в руководстве команду для установки, не пропуская мимо ушей то, что mysql не поддерживается начиная с Debian “buster” (10.3):

apt-get install apache2 mariadb-server php php-mysql libapache2-mod-php php-xml php-mbstring #без sudo, добавляем параметр -y, чтобы пропустить запросы с подтверждениями.

Необязательные компоненты

apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git -y
systemctl restart apache2

Настройка MySQL

mysql -u root -p
CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
CREATE DATABASE my_wiki;
use my_wiki;
GRANT ALL ON my_wiki.* TO 'new_mysql_user'@'localhost';
quit;
#Не для всех это очевидно, но вместо THISpasswordSHOULDbeCHANGED в кавычках действительно нужно указать другой пароль. 

Настройка PHP

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

• откройте в текстовом редакторе /etc/php/7.3/apache2/php.ini (например nano /etc/php/7.3/apache2/php.ini), не забудьте, что он должен запускаться из-под рута (выполните su, если это новый сеанс консоли)
• Увеличьте до необходимых значения
  
  • upload_max_fileseze = 2M #я для себя поставил 50. Для документов и изображений должно быть достаточно, а делать больше – стрёмно, человеческий фактор никто не отменял, кто-то может по невнимательности загрузить файлы, для которых этот портал не предназначен.
  • memory_limit = 128M #в руководстве рекомендуется минимум до 128, у меня так и было – не стал менять
• Сохраните изменения и выйдите из редактора
  
  • Ctrl+O, Ctrl+X для nano
  • :wq для vi

Контрольная точка «Установлен LAMP»

Без неё всё будет работать, и перед запуском в прод все контрольные точки (по крайней мере на Hyper-V) стоит удалить, но сейчас я настоятельно рекомендую этот снапшот сделать.

Установка MediaWiki

Первый вариант – скачать и распаковать.

Он описан в том же документе, и позволяет установить более актуальную версию:

cd /tmp/
wget https://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.0.tar.gz
tar -xvzf /tmp/mediawiki-*.tar.gz
mkdir /var/lib/mediawiki
mv mediawiki-*/* /var/lib/mediawiki

Второй вариант – установка из пакета.

Я выбираю его. Так будет проще обновляться в будущем.

apt-get install mediawiki -y

Версия доступного для ручной установки пакета выше (1.34 vs 1.31), apt-get update не находит обновлений. Меня это не смущает, но вы можете выбрать первый вариант установки, на дальнейшую настройку это не повлияет.

Создание контрольной точки «Установлена Mediawiki»

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

Настройка MediaWiki

Перейдите в браузере по ссылке http://ваш сервер/mediawiki и следуйте появляющимся инструкциям. При возникновении ошибок при открытии самой страницы, обратитесь к руководству, у меня их не возникало. #напомню, мой узел называется wiki02.aslan.local, далее на скринах и ссылках будет фигурировать именно он. И да, советую использовать FQDN. Не могу сказать, что это обязательно, но советую.

Язык

Ваш язык: ru – русский. Язык, который будет использовать вики: ru — русский

Убедитесь, что прошла проверка внешней среды

Параметры БД

• Укажите заданные при настройке MySQL имя базы данных, пользователя и пароль. Префикс таблиц БД указывать не обязательно, но я рекомендую – если завтра на этом же сервере захочется развернуть другую Вики, например, это очень выручит.
  
• Для доступа к базе данных из веб-сервера я использую ту же учётную запись.
  

Название

• Название вики – всего лишь текст, который будет отображаться в заголовке.
• Пространство имён проекта: я использовал то же, что имя вики.
• Учётная запись администратора
  
  • Ваше имя участника – я привык создавать одну «главную», безличную учётную запись, данные которой при необходимости смогу передать другим людям. Здесь поступлю так же, укажу portal02admin
  • Пароль. КО рекомендует использовать здесь пароль, не совпадающий ни с одним из использованных выше.
  • Адрес электронной почты я не буду указывать.
• Отложу тонкую настройку.
  

Настройки

• Я планирую хранить в Вики информацию разного уровня чувствительности, поэтому для себя выбираю закрытый профиль прав. В будущем рассчитываю использовать авторизацию Active Directory. Об этом, если звёзды сложатся, напишу отдельно. Выбирайте для себя подходящий — тут нет лучше/хуже/правильнее.
  Изменить профиль можно будет позднее, если сомневаетесь — тоже выбирайте закрытый.
• Включу WikiEditor, CodeEditor.
• Разрешу загрузку файлов.
• Все остальные настройки я оставлю пока по умолчанию.

Загрузка на сервер LocalSettings.php

Итак, на финальной странице установки MediaWiki нам предлагают скачать файл (обычно его загрузка происходит автоматически). В моём случае, т.к. это уже не первая инсталляция, его имя не стандартное – ‘LocalSettings (3).php’. Переименую его, указав вместо «3» адрес хоста и сегодняшнюю дату. Файл этот нужно загрузить на наш сервер, в указанную на странице директорию (там он уже должен называться именно LocalSettings.php, и не забудьте про регистр).

• Скачиваем на последней странице настройки файл конфигурации.

• Загружаем файл на сервер с Вики. Я выполнял настройку с удалённой машины под Windows, поэтому для передачи файла на сервер использую pscp. Далее инструкции для пользователей Windows, пользователи других систем наверняка разберутся сами. Пользователи, выполнявшие настройку с того же хоста, где установлена Вики, просто перемещают файл в /etc/mediawiki/LocalSettings.php, mv в помощь.

  
  

  • Для вашего удобства, разместите файл конфигурации и файл pscp.exe в одной папке. Папка Downloads вполне для этого подойдёт. Открываем окно команд powershell из этой папки (Shift+ПКМ по свободному «месту» в папке, либо перейдите в неё, используя команды powershell, например cd)

    
    

  • Выполняем команду в powershell:

    .\pscp.exe '.\LocalSettings (wiki02_20200225).php' [email protected]:/home/aslan/LocalSettings.php #Разъясню её по частям:
    #.\pscp.exe – собственно исполняемый файл
    # '.\LocalSettings (wiki02_20200225).php' – файл, который копируем
    #[email protected] – логин@адрес_нашего_сервера
    #:/home/aslan/ - каталог на сервере, куда сохраняем. Использую домашний каталог пользователя, т.к. при работе не под рутом другие не доступны для записи и возвращают ошибку Access Denied
    #LocalSettings.
     php – конечное имя файла в целевой папке

    
    
  
  
• Возвращаемся к терминалу нашего сервера и перемещаем файл конфигурации «куда надо»

  mv /home/aslan/LocalSettings.php /etc/mediawiki/LocalSettings.php#Снова напоминаю про регистр!

  Настройки применяются сразу.

  
  

Выделенный сервер под Linux — Official TF2 Wiki

From Team Fortress Wiki

< Linux dedicated server

Jump to: navigation, search

Содержание

• 1 Установка
• 2 Запуск
• 3 Правила iptables
• 4 Замечания
• 5 См. также

Установка

Напишите в терминале строки находящиеся ниже

sudo apt-get install lib32gcc1 (for 64-bit platform)
wget http://www.steampowered.com/download/hldsupdatetool.bin
chmod +x hldsupdatetool.bin
./hldsupdatetool.bin
type yes
./steam
./steam -command update -game tf -dir .

Запуск

cd orangebox
./srcds_run -game tf +map cp_badlands

Правила iptables

-A INPUT -i venet0 -p tcp -m tcp --dport 27015 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p tcp -m tcp --dport 27005 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27015 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27005 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p tcp -m tcp --dport 27016 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p tcp -m tcp --dport 27017 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p tcp -m tcp --dport 27018 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p tcp -m tcp --dport 27019 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p tcp -m tcp --dport 27020 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27016 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27017 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27018 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27019 -m state --state NEW,ESTABLISHED -j ACCEPT
-A INPUT -i venet0 -p udp -m udp --dport 27020 -m state --state NEW,ESTABLISHED -j ACCEPT

• Замечание: если работает модуль multiports, то можно вместить всё в два правила.
• Замечание: измените имя интерфейса (venet0) в соответствии с вашими настройками системы.

Замечания

1. Выделенный сервер не требует прав суперпользователя (root) для установки и запуска. Рассмотрите установку отдельной учётной записи пользователя для выделенного сервера (hlds).
2. Если ваш сервер использует 64-битную (AMD64) версию Linux, возможно вам понадобится установить некоторые пакеты для 32-битной поддержки (binary compatibility). Если у вас установлен дистрибутив Debian, просто напишите в терминале sudo aptitude install ia32-libs, это должно помочь.
3. server.cfg находится в папке orangebox/tf/cfg. Для информации по настройке сервера посмотрите Dedicated server configuration.
4. Не забудьте открыть порты 27000-27015 в вашем сетевом экране, если он у вас установлен.

См. также

• Windows dedicated server
• Dedicated server configuration

7 лучших самостоятельных вики-решений для малого и крупного бизнеса

Амрита Патхак в Хостинг | Последнее обновление: 17 ноября 2022 г.

Поделись на:

Сканер безопасности веб-приложений Invicti — единственное решение, обеспечивающее автоматическую проверку уязвимостей с помощью Proof-Based Scanning™.

Вы все еще руководствуетесь «книгой», когда дело доходит до изучения чего-то нового?

Ну да!

Уверен, многие из вас с этим согласятся.

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

Бьюсь об заклад, никто не забудет о популярных вики, таких как Википедия !

Многие из вас надеются найти информацию о любимом футболисте, поп-певце, технологиях и других областях.

Знаете ли вы, что Википедия в настоящее время насчитывает более 50 миллионов страниц на 314 языках?

Ну, вы знаете!

Вы заинтересованы в создании веб-сайта наподобие Википедии или базы знаний, которая поможет вашим клиентам узнать о ваших продуктах?

Вам повезло, эта статья как раз об этом!

Здесь я расскажу о том, что такое вики-программа, как она может вам помочь, а затем о некоторых самостоятельных решениях для нее.

Что такое вики-программа?

Программное обеспечение Wiki — это программное решение, которое вы можете использовать для создания, обмена и редактирования контента, а также для совместной работы и его организации.

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

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

Варианты использования программного обеспечения вики

• Для хранения и обмена знаниями и инструкциями по вашим продуктам/услугам.
• Внутренняя вики для совместной работы
• Классная вики для учителей, которые могут делиться материалами курса и руководствами со студентами
• Генерировать идеи и публиковать их на вики, чтобы люди могли добавлять к ней дополнительные предложения
• Работать как справочники
• Учебники и инструкции
• Вы можете представлять обсуждения по электронной почте в вики.
• Работает как блог для генеральных директоров, менеджеров и сотрудников

Зачем вам вики-программа?

Есть много преимуществ. Давайте рассмотрим некоторые из них.

Содержимое с возможностью поиска 🔍

Программное обеспечение Wiki позволяет людям легко находить архивную информацию с помощью встроенной поисковой системы.

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

Эффективное сотрудничество

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

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

Контроль качества 💯

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

Децентрализованное принятие решений 🤔

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

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

Хватит теории, пора показывать!

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

Wiki.js

Wiki.js — это мощная вики-программа с открытым исходным кодом, которая благодаря интуитивно понятному интерфейсу превращает документирование в удовольствие. Он совместим с MariaDB, PostgreSQL, MySQL, SQLite или MS-SQL Server и работает практически на любой платформе. Wiki.js работает на Node.js, который обеспечивает молниеносную производительность.

Вы можете гибко настроить внешний вид вашей документации в темном или светлом режиме. Сделайте вики приватной, общедоступной или сделайте и то, и другое, как считаете нужным. Он разумно использует доступные ресурсы, будь то высокопроизводительная виртуальная машина или Raspberry Pi.

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

Вы также можете интегрировать сторонние службы аутентификации, такие как GitHub, Google, Microsoft, Auth0, LDAP, Okta и другие, вместе с 2FA. Он имеет популярный редактор уценки с панелью инструментов и предварительным просмотром в реальном времени, простой в использовании редактор WYSIWYG, который могут использовать неспециалисты, и простой HTML для импорта предварительно отформатированных страниц.

Wiki.js также представит миграцию контента с использованием WikiText, табличных и оптимизированных для REST/GraphQL редакторов. Вы можете отслеживать изменения содержимого, сравнивать версии, чтобы увидеть разницу, возвращаться к прошлому состоянию или даже восстанавливать удаленные страницы или экспортировать версию страницы. Он доступен более чем на 40 языках, а также поддерживает родные языки с письмом справа налево.

Вы можете управлять мультимедийными ресурсами, редактировать изображения, выделять коды, создавать диаграммы, отображать математические выражения и добавлять видео и аудио. Wiki.js поставляется со встроенной поисковой системой и поддерживает облачный поиск, Elasticsearch и другие системы, такие как Sphinx, Manticore и т. д.

Резервное копирование содержимого с помощью GitHub, Azure DevOps, GitLab, DigitalOcean Spaces, Google Cloud Storage, Dropbox, Box, Google Drive и т. д.

DokuWiki

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

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

Разработчики сделали «ДокуВики» эффективным инструментом для совместной работы и ведения учета всех внесенных изменений. Различные варианты использования «Докувики»:

• Руководство по программному обеспечению
• База знаний
• Личный блокнот
• CMS – интрасеть
• Рабочее пространство проекта

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

Если вам нужна «ДокуВики» в облаке, вы можете попробовать Kamatera, которая предлагает установку в один клик и дает вам возможность размещаться в 13 центрах обработки данных по всему миру.

MediaWiki

MediaWiki была создана ведущими учеными в 2002 году. Это бесплатная вики-программа с открытым исходным кодом, которая расширяет возможности тысяч сайтов, организаций и компаний. Он включает в себя популярные вики, такие как Википедия, Викисклад, Викисловарь и многие другие.

MediaWiki помогает собирать знания, систематизировать их, а затем делать их доступными для всех. Это мощное, расширяемое, надежное и многоязычное программное обеспечение. Он написан на PHP, что упрощает его запуск в стеке LAMP. Он уже широко используется в течение многих лет; сейчас это одно из самых надежных вики-решений, доступных на рынке.

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

Для хостинга MediaWiki вы можете попробовать платформу A2.

XWiki

Еще одно решение для вики с открытым исходным кодом — XWiki, написанное на Java. Вы можете использовать его как вики 1-го поколения или вики 2-го поколения. Вики-сайты 1-го поколения в основном предназначены для совместной работы над контентом, а вики-сайты 2-го поколения предназначены для создания веб-приложений для совместной работы.

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

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

BookStack

Простая платформа для хранения и организации информации с помощью BookStack.

Одним из преимуществ BookStack является его простота; его редактор страниц включает простой интерфейс с WYSIWYG. Вы можете разбить контент на 3 реальные группы — страницы, главы и книги. Весь контент в BookStack доступен для поиска по этим трем группам и на уровне самой книги.

Связывайте документацию, связывая любой абзац напрямую. Настройте BookStack в соответствии с вашим конкретным вариантом использования и измените логотип, имя и поля регистрации. В дополнение к этому вы можете изменить видимость системы и выбрать, просматривать ее публично или нет.

BookStack работает на платформе PHP Laravel с MySQL в качестве базы данных. В результате, какую бы виртуальную машину вы ни использовали, производительность вряд ли будет проблемой. Помимо мощных функций связывания и поиска, вы получаете сортировку по книгам, управление изображениями и версии страниц.

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

Вы поклонник Markdown?

Хорошие новости!

BookStack поддерживает его в дополнение к предварительному просмотру всего, что вы пишете в своей документации. Он также позволяет интегрироваться с поставщиками аутентификации, такими как Okta, LDAP, Google, Slack, GitHub и AzureAD.

Gollum

Если вам нужен локальный интерфейс и хороший API, Gollum — ваш друг.

Нет, я не про «Горлума» из «Властелина колец».

Вместо этого Gollum представляет собой простое вики-решение для документации на основе Git. Его страницы могут быть разделены на каталоги так, как вам нравится.

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

Gollum совместим с вики-сайтами GitHub и поддерживает высококлассные функции, такие как диаграммы UML, аннотации с помощью CriticMarkup, математику с использованием MathJax, перенаправления, макросы, RSS-канал, цитирование, BibTeX и многое другое. Он работает в Unix-подобных системах, но вы можете использовать его в Windows, используя JRuby.

Outline

Outline считается одним из самых быстрых вики-решений для растущего бизнеса. Он позволяет создавать красивые и многофункциональные страницы, а также совместим с уценкой. Это программное обеспечение создано с использованием Node.js и React, поэтому вы можете оценить его преимущества, такие как высокая скорость, лучшая производительность и более простое программирование.

Для хранения файлов поддерживается хранилище объектов, совместимое с AWS S3 или S3.

Заключение

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

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

Если вы не готовы использовать собственное решение, вы можете в качестве альтернативы попробовать размещаемые вики-платформы.

Спасибо нашим спонсорам

Как создать вики для малого бизнеса

Откажитесь от руководства для сотрудников и подумайте о том, чтобы создать для своей команды корпоративную вики. Вики — это своего рода веб-сайт, который позволяет совместное редактирование группой пользователей, как и Википедия. Совместный характер может объединить команду и сэкономить ваше время на обучение новых сотрудников политикам компании, новым руководствам для сотрудников, шаблонам документов и всему остальному, что вам нужно.

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

Существуют разные подходы к созданию вики, и в этом руководстве подробно описаны два наиболее распространенных способа их создания. Первый — самый простой путь: пользовательские вики размещаются на сторонних сервисах и создаются с помощью настраиваемых интерфейсов. Второй — это продвинутый метод, который требует некоторых знаний в области веб-кодирования.

[ Связанный: Как создать веб-сайт для бизнеса ]

Услуги хостинга вики

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

Это одни из самых популярных сервисов.

• Wikidot — это корпоративный вики-хостинг с функциями для создания вики и других профессиональных веб-сайтов. Существует бесплатная версия для создания общедоступных вики-сайтов и платные премиум-версии (от 49,90 до 239,90 долларов США) для размещения частных вики-сайтов для ваших компаний. Он имеет неограниченное количество страниц для вашего сайта и место для хранения документов и других файлов, которыми вы можете поделиться в своей компании.
• Теттра , программа для размещения и редактирования вики, является надстройкой для программы чата Slack. Члены команды, подключенные через Slack, могут редактировать вики, добавлять страницы и обмениваться документами по всей компании. Tettra размещает весь ваш контент. Это платная услуга с различными тарифными планами в зависимости от размера вашей команды, начиная с 50 долларов в месяц для 20 пользователей и до 500 долларов в месяц для 300 пользователей.
• Викия наиболее известна тем, что размещает общедоступные вики о фандомах поп-культуры; однако пользователи могут бесплатно создавать вики-сайты на любую тему с помощью простого в использовании интерфейса. Нет возможности сделать приватную вики, и сервис запускает рекламу на сайтах.

Самостоятельный хостинг вики

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

Во-первых, вам понадобится место для размещения вашей вики. Вы можете использовать локальный сервер, которым уже владеет ваша компания, или арендовать место на сервере онлайн. Существуют некоторые облачные сервисы, такие как A2 Hosting, HostGator и Bluehost, которые оптимизированы для запуска программного обеспечения вики. Если вы планируете сделать свою вики общедоступной или доступной для ваших сотрудников из любого места, где есть подключение к Интернету, вам также понадобится веб-домен.

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

Далее вам потребуется программное обеспечение вики для создания и настройки вашей вики. Некоторые из наиболее популярных программ включают в себя:

• MediaWiki , программа с открытым исходным кодом, аналогичная используемой Википедией. Для его использования требуются базовые знания PHP-скрипта и кода CSS. Даже если вы не знакомы с программированием, на веб-сайте MediaWiki есть подробные инструкции по установке на ваш сервер и настройке вашей вики. Его можно бесплатно загрузить и использовать.
• TikiWiki — это система управления контентом (CMS) с полным набором функций программирования веб-сайтов, но по умолчанию это вики-платформа с необходимыми инструментами для создания вики-страницы вашей компании. Эта платформа имеет множество подключаемых модулей для дополнительных функций, таких как встроенное видео, документы и карты. TikiWiki имеет открытый исходный код и может быть загружена бесплатно.
• DokuWiki — это простая в установке вики-платформа, которая не требует таких знаний в области программирования, как MediaWiki. Он имеет понятный интерфейс и позволяет легко назначать приоритеты доступа членам команды. DokuWiki также имеет открытый исходный код и бесплатна.

Создание вашей вики

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

Редактирование собственной вики-страницы более сложно и потребует некоторых навыков веб-дизайна, в зависимости от вашего программного обеспечения. Общим языком кодирования для программного обеспечения вики и программного обеспечения для веб-дизайна в целом является CSS. Это управляет внешним видом и расположением вашей вики. К счастью, в Интернете можно найти множество готовых шаблонов CSS. Все, что вам нужно сделать, это скопировать код и вставить его в соответствующее место в вашем программном обеспечении.

Другой код, который вам нужно знать, — это вики-разметка, которая управляет форматированием содержимого вашей вики. Вместо привычной панели инструментов форматирования текста, чтобы изменить тип заголовка, шрифт, размер и другие аспекты вашей вики, вам необходимо ознакомиться с языком разметки вики. Разметка Wiki основана на HTML.

Резюме

Создание вики-сайта — отличный инструмент для общения, позволяющий сотрудникам быть в курсе процедур и правил вашей компании.