
一个很棒的自动启动器生成器,可以跳到您的项目!
探索文档»
查看演示。报告错误。请求功能

构建和为开源软件做出贡献的挑战之一是,尽管许多项目具有惊人的功能,但由于缺乏清晰且用户友好的安装说明,他们常常错过吸引更广泛的受众。此外,缺乏有效的用例也有助于这些项目的较低覆盖范围。
虽然有读数模板可以帮助解决此问题,但是手动填写这些模板的过程可能是耗时且乏味的。这就是我们的项目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生成的