最簡單的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
。
再次不要驚慌!只需在地址之後添加`/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建造