Один из открытых проектов, основанный на GraphQL, Nuxt.js, MongoDB и Keystone.js — это система для редактирования документов в реальном времени. Она может быть использована для различных целей: онлайн-редактирование и демонстрация документов, поддержка синтаксиса Markdown.

Если вы считаете, что это слишком сложно, вы можете просто использовать Qi Meng (企萌) сеть: https://www.iqi360.com. Вы сможете создать проектный веб-сайт за две минуты. Несколько человек могут совместно редактировать и добавлять документы, разрабатывать схемы маршрутов и использовать функцию полнотекстового поиска.

Иллюстрации:

• Главная страница:
  • [Рисунок не найден]
• Внутренняя страница:
  • [Рисунок не найден]
• Демонстрация на мобильном устройстве:
  • [Изображение не найдено]

Отличительные функции: Динамическая система редактирования в реальном времени, ориентированная на мобильные устройства и рендеринг на стороне сервера, оптимизированная для SEO. Подходит для небольших и крупных проектов онлайн-документации.

Журнал обновлений: 26 сентября 2020 года: добавлен инструмент автоматического обновления библиотеки с использованием команды:

yarn upgrade @keystonejs

После запуска инструмент автоматически обновит библиотеку Keystone до последней версии, решая проблемы с ошибками, вызванными версиями.

30 августа 2020 года: все библиотеки были обновлены до последних версий, устраняя проблемы с невозможностью запуска и установки.

18 июня 2020 года: добавлена возможность перехода от последнего документа в категории к первому документу в следующей категории и наоборот.

Метод установки: Ubuntu 18.04: Установка Node.js:

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

Установка MongoDB:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org
sudo systemctl start mongod
mongo
use admin
db.createUser( { user: "admin", pwd: "<Введите безопасный пароль>", roles: [ { role: "root", db: "admin" } ] } )
use topdocs
db.createUser( { user: "topdocs", pwd: "topdocs", roles: [ { role: "readWrite", db: "topdocs" } ] } )
exit
vim /etc/mongod.conf
<!-- добавить строки -->
security:
  authorization: enabled
<!-- выйти из редактирования -->
sudo systemctl restart mongod

Установка TopDocs:

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn
git clone https://gitee.com/quazero/topdocs
cd topdocs
yarn

Привязка домена и SSL: после того как вы привяжете домен, например docs.moejj.com, создайте новый файл .env:

ENDPOINT=https://docs.moejj.com/admin/api
MONGOURI=mongodb://topdocs:topdocs@127.0.0.1:27017/topdocs
COOKIESECRET=thisismysecretcookies

После компиляции запустите приложение:

yarn build
export NODE_ENV=production
nohup node server.js &
exit

Обратите внимание: После запуска приложения перейдите в бэкэнд по адресу /admin. Используйте учётные данные администратора: admin@admin.com и пароль adminadmin. Измените их самостоятельно в настройках. В настройках index является содержимым главной страницы. Обратите внимание на следующее:

-logo-/logo.png-logo-
-title-Межпоколенческая система редактирования документов-title-
-subtitle-Система динамического редактирования документов в режиме реального времени на основе графов, MongoDB, Keystone.js и Nuxt.js. Ориентирована на мобильные устройства, использует рендеринг на сервере.-subtitle-
-button-Просмотр документов$https://gitee.com/quazero/topdocs-button-
===header===
Ниже header находится область для написания содержимого главной страницы в формате markdown. После завершения редактирования изменения можно увидеть на главной странице.

Между -logo- находится изображение логотипа, которое можно связать или указать путь. Между -title- находится большой заголовок главной страницы. Между -subtitle- находится описание проекта на главной странице. -button- содержит содержимое кнопки на главной странице, где <имя кнопки>$<ссылка>. Ссылка может быть связана или указывать путь, в зависимости от ваших потребностей. ===header=== ниже находится область, где можно написать содержимое главной страницы в формате Markdown.