最简单的node.js cms&ssg!
在错误的黑暗中,一个微小的火焰...
重要的
该文档不再代表博客-Doc的各种功能。请咨询综合文档以获取有关博客DOC功能的最新信息。
要在空间上安装博客DOC,请越过其安装页面,然后单击Install App
按钮。
安装后,从您的地平线上打开应用程序,或访问应用程序的构建器实例并单击Open Builder Instance
按钮。
您将被重定向到应用程序的地址,并在浏览器中查看以下消息: Route Not Found
。
请不要害怕!我已经尝试了其他一些方法,但这是最简单,最安全的方法。
现在假设您的博客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秒才能上传配置,然后您将重定向Route Not Found
初始地址https://abc-1-x234.deta.app
,然后再次查看: Route Not Found
。
再次不要惊慌!只需在地址之后添加`/pages/documentation'。在应用程序中浏览一分钟(代码与新创建的驱动器进行交互的时间)而无需访问家庭路线,然后转到主要路线并开始使用您自己的博客DOC实例?
如果它从第一次不起作用,那么它将再次进行。
siteURL
值,在管理下的“设置”页面中提供网站的实时URL 。
Nota Bene:实时URL必须以斜线的结尾/
当然,您还必须在“设置”页面中修改siteTitle
, siteDescription
和rssCopyright
。
您应该用网站替换siteTitle
, siteDescription
和rssCopyright
值。
您可以用网站的语言替换rssSiteLanguage
值。
可用语言代码的列表可以在RSS语言代码页面上找到。
⬆️回到功能
像RSS feed一样,您必须通过修改siteURL
值来为每个页面,帖子,标签和模板以及博客路由生成正确的链接,从而在设置页面中提供网站的实时URL 。
请记住,网站URL必须以斜线的结尾/
您可以在/sitemap
路由下检查网站的站点地图。
⬆️回到功能
博客DOC具有内置搜索功能。
搜索功能允许用户对帖子的标题和内容进行研究。
您可以在/search
路由下检查网站的搜索。
您可以通过在网站设置页面中为searchFeature
提供一个false
的值来禁用node.js应用中的搜索以及生成的静态站点。
⬆️回到功能
Blog-Doc使用亮点。JS突出显示代码的块。
要编写内联代码,请用反向``
要突出显示它,通过将其卷曲的括号与代码语言的别名相同,为内联代码提供语言。
以下示例将为您一个更好的主意。
假设此css
行p : color { red }
,为了突出显示它,您将写`p { color: red }`{language=css}
。
该代码周围环绕着``
'```` {language=alias of code language}
要编写一个代码块,请用一对3个回弹围住您的块```
。
为了突出显示,在前3个背部后,为块提供语言的别名。
我们将以上一个示例为例,将其强调为一个块:
```css
p { color: red }
```
我们将获得以下输出:
p {
color : red;
}
如果您不确定,请访问亮点的支持语言以获取正确的别名。
另外,您可以编写一个代码块而不提供别名,亮点。JS将自动检测该语言。
如果荧光笔未能检测到没有别名的代码块的正确语言,只需如上所述,将所需的语言添加到块中。
⬆️回到功能
默认情况下,仅将id
属性添加到标签标签,仅H2到H4,是可选的激活功能。
此功能是用边缘案例构建的,并牢记了错别字:
要添加id
,请添加带有主题标签的卷曲括号,然后添加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 >
每个空格都会被连字符自动取代,并且任何数量的连续连字符仅被一个连字符所取代。
删除ID文本的开始或结束时的任何数量的连字符,因此以下情况也有效:
## 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 >
在最后一个主题标签被忽略之前的任何内容,并且ID文本中的特殊字符也被忽略:
## 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
路线访问画廊,或者转到管理页面,然后单击菜单中的画廊链接或卡片。
本着Blog-Doc的全球精神,厨房使用非常简单。
您会找到一个掉落区域,可以在其中删除图像或单击它,然后选择要上传的图像。
您还可以通过单击其✘删除按钮从图库中删除图像。
最后,要将图像分配到页面或帖子中,您可以在创建或更新时,通过直接从页面或帖子中选择图像来选择图像。
⬆️回到功能
(即将到达太空)
您可以在主题之间切换并选择适合您需求的设计。
Blog-Doc随附:
如果一张图片价值一千个单词,则视频价值一百万!
一个30秒的视频,显示了通过博客DOC立即改变网站外观和感觉的能力。
随着时间的流逝,我将为博客添加更多主题。
如果您已经为博客DOC编码了一个主题,并希望将其列在可用的主题中,则可以在Blog-Doc的“想法类别”下的博客DOC存储库的讨论中知道。
请记住,博客主题必须只使用普通的JavaScript,并且不能包含具有发布和/或发行限制的任何代码或图像!
⬆️回到功能
所有的开发人员的时间和辛勤工作都得到了应有的尊重。
我对这些开发人员的每个开发人员都提前道歉,但是一个应用不应该是煤气工厂...
虽然以下帖子与Blog-Doc的实际版本不再相关,但它们很好地解释了我的动力,并可能会震惊您。
请阅读145到7?
还请阅读新的博客-Doc
另外,请阅读node_modules并不是很重,开发人员很懒惰!
现在,空间的博客DOC仅使用14个模块(1916.1 KB或1.9161 MB),而不是131(10082 KB或10.082 MB)!
转到GitHub上博客DOC空间的问题页面,并通过尽可能多地解释您面临的问题来创建一个新问题。
转到Github上的博客空间的想法,然后告诉我。
包括空间博客的SSG需要一些架构修改。
稍后,我将考虑包括SSG或不依赖博客-Doc的空间用法和要求。
请阅读安装部分。
我打算在短暂的空闲时间对此应用进行大量改进。
您可以将Blog-Doc作为原型,并将其完全修改,以与其他设计和/或其他模板语言一起使用。
我真的希望这个应用程序对很多人都会有用,我将其视为我对Node.js和Markdown社区的个人贡献。
最欢迎想法,评论和建议。
Sya,Lebcit
由lebcit建造