Живой сервер для статических веб-сайтов Markdown

В настоящее время я изучаю генераторы статических сайтов. Я создаю сайт с документацией по тестированию с помощью Vuepress и сейчас возюсь с переходом в режим реального времени. я не хочу публиковать свои файлы в службах (GitHub Pages, Netlify и т. д.), но я хочу разместить их на своем собственном сервере. Создание статических html-сайтов каждый раз, когда я добавляю страницы уценки или меняю контент, не вариант. Есть ли способ разместить Vuepress (или, возможно, аналогичные генераторы уценки), где мне просто нужно загрузить файлы .md, и все пойдет автоматически?


person Jxns    schedule 17.03.2021    source источник


Ответы (1)


Есть два основных способа использования уценки в качестве веб-сайта...

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

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

Чтобы ответить на ваш вопрос, можете ли вы использовать vuepress и каким образом:
Существует несколько возможных способов, в зависимости от вашей текущей настройки.
Если у вас есть только какое-то веб-пространство, вам нужно загрузить предварительно обработанные HTML-файлы (или использовать другой фреймворк).
Если у вас есть виртуальный сервер, вы можете автоматизировать процесс сборки/рендеринга с помощью скриптов, например. грамм. с файловыми наблюдателями.

Примечание для GitHub:
Даже если вы сказали, что не хотите использовать GH... Если вы хотите скрыть только файлы уценки, вы можете создать частный репозиторий и использовать GH Actions в качестве конвейера CI/CD. .

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

person D. Weber    schedule 17.03.2021
comment
Существует третья возможность, и я предполагаю, что ОП на самом деле спрашивает: у вас может быть «одностраничное приложение», которое загружается в ваш браузер. Затем Javascript на этой странице извлекает статические файлы Markdown с сервера, пропускает их через анализатор Markdown, а затем вставляет обработанный HTML-код на страницу. Я видел пару таких примеров в последние годы. Тем не менее, они, безусловно, не являются основным/типичным способом ведения дел. Я не могу вспомнить, где я это видел, и не мог бы дать рекомендацию, если бы это было по теме. - person Waylan; 18.03.2021