Как сделать раздел «Документация» для сайта?

Question

[maximus]

Добрый день!

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

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

Подскажите, какое решение можно использовать, желательно не слишком весомое и на PHP.

Что нравится в плане интерфейсов:
- flarum.org/docs
- docs.raneto.com
- docs.unipag.com
- help.yandex.ru
- pomoc.siteor.pl

Answer 1

[Эдуард Тибет]

1. Упомянутый вам help.yandex.ru сделан не на php - это собираемая на кластере статика с использованием единого источника DITA. Это совершенно другой уровень. Не думаю, что вам требуются его возможности.

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

Comments

[maximus]

в плане интерфейсов.. а не в техническом плане..

[Эдуард Тибет]

maximus: секунду... вы не поняли. Вы определились с форматом _хранения_ документации? Если да, то один путь. Если нет, то другой.

[Эдуард Тибет]

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

[maximus]

Эдуард Тибет: подойдут и обычные статьи разбитые на категории. хочу систематизировать руководство по сайту и вопросы и ответы, которые могут возникнуть у пользователя. Я не в курсе как устроена архитектура "как у Яндекса", но прочитал про DITA, за что Вам спасибо

[Silm]

- "подойдут и обычные статьи разбитые на категории."

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

[maximus]

Silm: может и так, а вот на какой CMS

[Silm]

maximus: вы хотите отдельную CMS под раздел сайта? Зачем?

[Эдуард Тибет]

maximus: DITA вам не нужна, уж поверьте :)
Если вы определились с форматом (например, Markdown), тогда дальше уже ищите примеры отображения и смотрите, каким образом это устроено у каждой системы.
Почему так? Просто text-based форматы (adoc, md, rst) в это плане более требовательны к изначальной структуре - т.е. вы не сможете потом автоматически их разбивать на куски (про использованием sed/awk я не говорю). С xml-based форматами (Docbook, DITA) в этом смысле проще, т.к. всегда есть xslt, который разобьет вам все, как надо в любой пропорции.

[Silm]

Эдуард Тибет: да по моему человеку нужно вообще что то из другой оперы.

[Silm]

maximus: вики-движки не рассматривали?