
一個很棒的自動啟動器生成器,可以跳到您的項目!
探索文檔»
查看演示。報告錯誤。請求功能

構建和為開源軟件做出貢獻的挑戰之一是,儘管許多項目具有驚人的功能,但由於缺乏清晰且用戶友好的安裝說明,他們常常錯過吸引更廣泛的受眾。此外,缺乏有效的用例也有助於這些項目的較低覆蓋範圍。
雖然有讀數模板可以幫助解決此問題,但是手動填寫這些模板的過程可能是耗時且乏味的。這就是我們的項目makeread.me的來源。
介紹Makeread.me,一種自動化的自動化信息生成器,可以徹底改變您創建項目文檔的方式。它旨在:
它是免費的,開源的,並且可以自定義。隨意修改我們的模板以滿足您的需求。如果您發現缺少特定的組件,則非常歡迎您貢獻和擴展項目。
我們使您可以輕鬆地通過使用Nunjucks和JSON模板進行程序化映射為項目做出貢獻。與Makeread.me一起享受清晰簡潔的項目文檔的好處!
該項目是通過以下技術構建的:
這是您如何在本地設置項目的說明的一個示例。要獲得本地副本並運行,請按照以下簡單的示例步驟進行操作。
該項目需要在系統中安裝紗線。如果您沒有安裝它,則可以按照以下步驟操作:
使用NPM(Node Package Manager)在全球安裝紗線。打開終端並運行:
npm install -g yarn請確保在運行紗線之前安裝了Node.js和NPM。
通過在您的終端中運行以下命令來驗證紗線已安裝在計算機上:
yarn --version如果正確安裝了紗線,則您的終端應顯示機器上安裝的紗線版本。
現在,您準備使用紗線來管理和版本掌握項目依賴項!
請按照以下步驟成功安裝:
克隆存儲庫:開始將存儲庫克隆到本地計算機。
https://github.com/ShaanCoding/makeread.me
安裝前端軟件包:導航到“/frontend”目錄,並通過在終端中執行以下命令來安裝所需的紗線軟件包:
yarn install安裝後端軟件包:類似地,導航到“/後端”目錄,並通過在終端中執行以下命令來安裝所需的紗線軟件包:
yarn install設置環境:
在“/後端”目錄中,複製“ .env.example”文件的內容,然後創建一個名為“ .env”的新文件。根據您的要求調整環境變量,也可以將其視為原樣。
導航到“ frontend/api/oferated/readmegenerator.ts”,並將基本參數設置為後端API路由。例如,如果您要在端口8080的本地服務器上運行後端,則應設置:
BASE: "http://localhost:8080/api" ;運行後端:導航到“/後端”目錄,然後在終端中鍵入以下命令以運行您的後端服務器:
yarn dev運行前端:最後,導航到“/frontend”目錄並在終端中鍵入以下命令以運行前端服務器:
yarn dev現在,您的應用程序應該成功啟動並運行!
路線圖包括完整的和未來的目標。這是我們所取得的成就,並期待:
我們繼續致力於改善和擴展makeread.me的功能,為用戶提供高效且無縫的自生生成體驗。
有關擬議功能(以及已知問題)的完整列表,請參見開放問題。
貢獻是使開源社區成為學習,啟發和創造的驚人場所的原因。您所做的任何貢獻都非常感謝。
如果您有一個可以使情況變得更好的建議,請分配存儲庫並創建拉動請求。您也可以簡單地使用標籤“增強”打開問題。別忘了給項目一個明星!再次感謝!
git checkout -b feature/AmazingFeature )git commit -m 'Add some AmazingFeature' )git push origin feature/AmazingFeature )根據Mozilla公共許可證2.0許可分發。有關更多信息,請參見Mozilla公共許可證2.0許可證。
如果您有任何疑問或建議,請隨時與我們聯繫:
特別感謝以下貢獻,支持和靈感:
此讀數是使用makeread.me生成的