前言
Essay新版本終於肝完了,這是我17年寫的一個項目,本來都不打算更新了,只是最近在使用第三方平臺寫筆記的時候被噁心到了,想遷移文章發現也很費勁,就想着還是整一個自己喜歡的吧,於是就又撿起來了。
新版本做到了即使完全不懂技術也可以使用的簡單程度,圖形化配置安裝,這相對於之前的版本是一次進步和嘗試。
在技術上,這次也做了各種取捨,爲了保證整體的寫作體驗和瀏覽體驗,前端沒有使用類似Vue、React這種框架,也沒有使用Jquery,只引入了必要的庫和一個極小的UI,使用傳統方式渲染。
在數據庫上選擇上,使用了更爲輕量的SQLite,這也是嘗試了各種數據庫後的折中選擇。
靜態資源的存儲,放棄了使用CDN,轉而使用最基礎的本地存儲。
可以說這次更新,除了必要的開發依賴,做到了儘可能不依賴第三方服務。本次更新完成後,我也把散落在各個平臺的筆記全部遷移過來了。
安裝步驟
安裝前請確保本地的Node
版本大於16,本機已安裝sqlite
# 下載項目
git clone https://github.com/wmui/essay.git
# 安裝依賴
yarn install # or npm install
# 啓動項目
npm run start
項目啓動後,訪問http://127.0.0.1:7001/install
,進入安裝界面:
點擊下一步,設置管理員密碼:
點擊完成設置,安裝就完成了,超簡單
開始寫作
極致的markdown寫作體驗,在功能設計上,只提供了必要選項。
可以把重要文章置頂,同時可以選擇在導航欄顯示文章,這樣文章就相當於單頁了,使用markdown設計出不同的展示頁面,比如“關於我們”。
草稿箱的設計不僅用於放草稿,之前的版本我有設計公開分類和私有分類功能,這次全部割掉了,用草稿箱代替私有文章。
標題輸入框也被我割掉了,會自動讀取內容的第一個h1 - h6
標籤作爲標題,爲的是沉浸式寫作體驗。
文章提供自動保存功能,在寫作過程中無需擔心內容丟失。
功能說明
這次更新相比於之前的版本,閹割掉了很多功能,可以說越更新功能越少,但已有的功能也相對的靈活了很多。整個設計一共就三張表,後面也不會加了,單用戶博客,後面也不會改成多用戶。
沒有前後臺的設計,管理員和遊客看到的頁面是一樣的,編輯和刪除在文章詳情頁完成。
評論功能也去掉了,加了一個留言板。
必要的修改項統一放到設置裏面
結語
這個項目一直是作爲技術實踐的,因爲功能簡單,所以代碼閱讀和重構都很簡單。如果這個項目對大家學習有幫助,或者只是單純的對使用到的技術感興趣,希望能點個小小star。
github: https://github.com/wmui/essay
預覽:https://ppx.link
以上,感謝閱讀!