blog doc space
v5.4.1
Самый простой node.js cms & ssg!
Крошечное пламя в темноте ошибки ...
Важный
Эта документация больше не представляет разнообразные функции блога. Пожалуйста, проконсультируйтесь с комплексной документацией для актуальной информации о функциональных возможностях Blog-Doc.
Чтобы установить Blog-DOC на космос, перейдите по его странице установки и нажмите кнопку Install App .
После установки откройте приложение из вашего горизонта или, получив доступ к экземпляру приложения застройщика и нажав кнопку Open Builder Instance .
Вы будете перенаправлены на адрес приложения и увидите в вашем браузере следующее сообщение: Route Not Found .
Пожалуйста, не волнуйтесь! Я попробовал некоторые другие способы, но это самый простой и самый надежный.
Теперь предполагая, что ваш экземпляр Blog-Doc имеет следующий адрес:
https://abc-1-x234.deta.app , в адресной строке вашего браузера.
Добавьте после этого /admin-blog-doc-config , адрес сейчас:
https://abc-1-x234.deta.app/admin-blog-doc-config , нажмите Enter.
Вы будете перенаправлены на страницу, которая поможет вам установить основную конфигурацию, чтобы начать использовать блог-DOC, 2 простых шага 2 минуты.
В конце вы отправите форму, на загрузку конфигурации требуется не более 30 секунд, затем вас перенаправляют на начальный адрес https://abc-1-x234.deta.app и еще раз посмотрите: Route Not Found .
Опять не паникуйте! Просто добавьте `/pages/documentation` `после адреса. Просмотрите приложение на минуту (время, когда код будет взаимодействовать с недавно созданным диском) без посещения домашнего маршрута, затем перейдите по основному маршруту и начните использовать свой собственный экземпляр Blog-Doc?
Если это не сработает с первого раза, сделайте это снова еще раз, и это произойдет.
siteURL перед развертыванием приложения.
Nota Bene: Live URL должен закончиться с помощью чернила /
Конечно, вы также должны изменить siteTitle , siteDescription и rssCopyright на странице настроек.
Вы должны заменить значения siteTitle , siteDescription и rssCopyright на те, которые вашего сайта.
Вы можете заменить ценность rssSiteLanguage на язык вашего сайта.
Список доступных языковых кодов можно найти на странице кодов языков RSS.
⬆ Вернемся к функциям
Как и RSS -канал, вы должны предоставить Live URL -адрес вашего сайта на странице настроек, изменив значение siteURL для создания правильных ссылок для каждой страницы, публикации, тега и шаблона, а также для маршрутов блога.
Пожалуйста, помните, что URL сайта должен заканчиваться с помощью чернила /
Вы можете проверить карту сайта вашего сайта по маршруту /sitemap .
⬆ Вернемся к функциям
Blog-Doc имеет встроенную функцию поиска.
Функциональность поиска позволяет пользователю провести исследование названий и содержимого постов.
Вы можете проверить поиск вашего сайта по маршруту /search .
Вы можете отключить поиск в приложении Node.js, а также для сгенерированного статического сайта, предоставив searchFeature значение false на странице «Настройки сайта».
⬆ Вернемся к функциям
Blog-Doc использует hight.js для выделения блока кода .
Чтобы написать встроенный код , окружи свой код с помощью обратных `` .
Чтобы выделить его, предоставьте язык для встроенного кода , поместив после него вьющиеся скобки со псевдонимом языка кода.
Следующие примеры дадут вам лучшую идею.
Предполагая, что эта линия css p : color { red } , чтобы выделить ее, вы напишите `p { color: red }`{language=css} .
Код окружен вызорами `` и за ним следует {language=alias of code language} .
Чтобы написать блок кода , окружайте свой блок парой из 3 обратных и бэктиков ``` .
Чтобы выделить его, предоставьте псевдоним языка для блока сразу после первых 3 бэктиков.
Мы возьмем предыдущий пример и выделим его как блок:
```css
p { color: red }
```
Мы получим следующий вывод:
p {
color : red;
}Посетите поддерживаемые языки hight.js, чтобы получить правильный псевдоним, если вы не уверены.
В качестве альтернативы, вы можете написать блок кода, не предоставляя псевдоним, hoald.js автоматически обнаружит язык.
Если маркер не может обнаружить правильный язык для блока кода без псевдонима, просто добавьте желаемый язык в блок, как указано выше.
⬆ Вернемся к функциям
Добавление атрибута id в заголовок, только H2 до H4, по умолчанию является необязательной активированной функцией.
Эта функция была построена с помощью краевых случаев и набрать опечатки:
Чтобы добавить id , добавьте вьющиеся скобки с хэштегом, за которым следует текст идентификатора.
Следующие примеры дадут вам лучшую идею:
<!-- Heading tags with an id property -->
## My awesome H2 title {# my-awesome-h2-title}
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
### My awesome H3 title {# my awesome h3 title}
The HTML output will be : < h3 id = " my-awesome-h3-title " >My awesome H3 title</ h3 >
#### My awesome H4 title {# My awesome H4 title}
The HTML output will be : < h4 id = " my-awesome-h4-title " >My awesome H4 title</ h4 > Каждый пробел автоматически заменяется дефисом, и любое количество последовательных дефисов заменяется только одним дефисом.
Любое количество дефиса в начале или конец текста идентификатора удаляется, так что следующее также действительнее:
## My awesome H2 title { # ----- My ----- aWEsOMe ----- h2 ----- tITlE ----- }
Whatever the number of whitespace characters / hyphens is at the beginning,
between the words or at the end, the HTML output will still be :
< h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >Все, что до последнего хэштега игнорируется, и особые символы в тексте идентификатора тоже игнорируются:
## My awesome H2 title { /!@# a comment ?%^& # -my= awesome+ h2 ( title ) | }
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >& will be parsed to amp (ampersand)
" will be parsed to quot (quotation)
> will be parsed to gt (greater then)
< will be parsed to lt (less then)В качестве примера:
## Honey & Bees {#Honey & Bees}
The HTML output will be : < h2 id = " honey-amp-bees " >Honey & Bees</ h2 > Если вы хотите отключить эту функцию, установите значение addIdsToHeadings на false на странице «Настройки сайта».
⬆ Вернемся к функциям
Поскольку Blog-Doc превратился в CMS, я планировал добавить галерею и способ получить изображения для страниц и постов напрямую.
Теперь это почти сделано. Почти, потому что всегда есть место, чтобы принести улучшения.
На данный момент вы можете посетить галерею, нажав по маршруту /admin/gallery/images , или перейдите на страницу администрирования и нажмите на ссылку Gallery в меню или его карте.
В глобальном духе блога Doc камбуз довольно прост в использовании.
Вы найдете зону выброса, где вы сможете сбросить изображения (ы) или нажать на нее и выбрать изображения (ы), которые вы хотите загрузить.
Вы также можете удалить изображение из галереи, нажав кнопку «Удалить» .
Наконец, чтобы назначить изображение на страницу или пост, вы можете, создавая или обновляя, выбрать изображение из галереи, выбрав его непосредственно со страницы или поста.
⬆ Вернемся к функциям
(Скоро в космос)
Вы можете переключаться между темами и выбрать дизайн, который соответствует вашим потребностям.
Блог-DOC поставляется:
Если картина стоит тысячи слов, видео стоит миллион!
Видео 30 секунд, показывающее возможность мгновенно изменить внешний вид вашего сайта с помощью блога.
Я буду добавлять больше темах в блог с течением времени.
Если вы кодировали тему для блога-DOC и хотите перечислить ее среди доступных тем, вы можете сообщить мне в обсуждении репозитория Blog-DOC в рамках категории идей.
Пожалуйста, имейте в виду, что темы блога должны использовать только простой JavaScript и не могут содержать какой-либо код или изображения, которые имеют ограничения публикации и/или распространения!
⬆ Вернемся к функциям
При всем уважении к времени и тяжелой работе каждого разработчика, который сделал статический генератор сайтов с node.js, включая предыдущие версии Blog-Doc , это Gasworks!
Я заранее предлагаю свои искренние извинения каждому из этих разработчиков, но приложение не должно быть газовым заводом ...
Хотя следующие сообщения больше не имеют отношения к фактической версии Blog-DOC, они довольно хорошо объясняют мою мотивацию и могут шокировать вас.
Пожалуйста, прочитайте с 145 до 7?
Также прочитайте новый блог-DOC
Также читайте node_modules не тяжелый, разработчики ленивы!
В блоге Doc для космоса теперь используется только 14 модулей (1916,1 КБ или 1,9161 МБ) вместо 131 (10082 КБ или 10,082 МБ)!
Перейдите на страницу проблем Blog-Doc Space на GitHub и создайте новую проблему, объяснив как можно больше проблемы, с которой вы сталкиваетесь.
Перейдите к идеям Blog-Doc Space на GitHub и расскажите об этом.
Включение SSG в блоге DOC на космосе требует некоторых модификаций архитектуры.
Позже я рассмотрю, чтобы включить SSG или не в зависимости от использования и требований Blog-Doc в космосе.
Пожалуйста, прочитайте раздел установки.
Я намерен сделать много улучшений в этом приложении за короткое свободное время.
Вы можете взять Blog-Doc в качестве прототипа и полностью изменить его, чтобы использовать его с помощью другого дизайна и/или другого языка шаблонов.
Я действительно надеюсь, что это приложение будет полезным в любом случае для многих людей, я рассматриваю это как свой личный вклад в Node.js и Markdown Communities.
Идеи, комментарии и предложения наиболее приветствуются.
Sya, Lebcit
Построен с ❤ от lebcit
