DrissionPageDocs

介绍

本仓库是开源工具 DrissionPage 4.0 的软件文档网站项目，本项目使用 mkdocs 工具构建。

• DrissionPage 项目的仓库地址为 https://gitee.com/g1879/DrissionPage
• 本软件文档项目的仓库地址为 https://gitee.com/g1879/DrissionPageDocs
• 本软件文档项目生成的网站主页网址为 https://g1879.gitee.io/drissionpagedocs/

DrissionPage 项目和本文档项目都欢迎各位有志之士参与贡献，为开源项目建设添砖加瓦！

文档网站使用说明

1. 点击文档主页链接可访问网站主页。
2. 上方导航栏有不同栏目，可以查阅相关内容。
3. 右上角有搜索框，可以通过关键词搜索到网站中的相关内容。

参与贡献

开源的理念之一就是“许多人的举手之劳可以创造一件伟大的作品”，而且，“只要眼睛越多，bug 就越少”。所以，欢迎大家参与贡献——在这里多看一眼，多发现一些问题，多解决一些问题，这样本项目就能更好地成长。

如果觉得本文档的内容需要修改或补充，欢迎添加Issue（提案）提出宝贵意见，更欢迎提出 Pull Request（拉取请求，简称PR）来直接修改文档。下面介绍对本文档提出 Issue 和 PR 的方法。

提出 Issue（提案）

Issue（提案）是使用者与开发者、不同开发者之间相互沟通的良好手段。通过提出 Issue 可以将 bug 公之于众，也可以让开发者了解对使用者来说更实用、更需要的功能。也欢迎所有人通过 Issue 提出自己的疑问、解决他人的疑问，提问和解答都是提高自己水平的好方法。以下是使用 Issue 提案的步骤。

1. 点击项目仓库上方 Issues 按钮
2. 在 Issues 页面，点击右侧的新建 Issue 按钮
3. 在新建 Issue 页面填写标题和详细的提案内容，右侧有一些可选的补充内容
4. 点击创建按钮，完成 Issue 发布。

提出 PR（拉取请求）

Issue 只是一种更新建议，实际的变更内容还是需要等待其他人来撰写，这样可能会有时效性差、效果不佳等缺点。其实所有用户都可以直接参与内容修改，直接修改您认为存在缺陷内容的文件，并将修改完成的结果提交给管理员进行审核，审核通过后您修改过的内容即可显示在文档网站上，可以帮助到更多的人。提出 PR 前建议先提出一个相关的 Issue 。以下是使用 Pull Request 请求的步骤。

1. Fork 本仓库 。Fork 之后可以在自己的仓库修改文档内容。点击 Fork 可以从右侧，也可以从底部。
2. 找到要修改的内容 。记下需要修改的文档网页的url地址（在浏览器地址栏中），来到自己账号的仓库中刚刚 Fork 的 beta4 仓库，点击 docs 文件夹，根据刚刚记下的url地址点开对应的文件夹中的md文件。例如假设“元素交互”页面需要修改，查看其url是/beta4/ChromiumPage/element_operation/，那么就从自己的仓库找到 beta4/docs/ChromiumPage/element_operation.md 文件，点击进入。 在文件内容页面，点击“编辑”，即可在线编辑修改。
3. 修改并提交代码 。内容修改完成后，还要补充填写提交信息、扩展信息，以告知大家修改的必要性，然后可以点击提交。
4. 新建 Pull Request 。在自己 Fork 的仓库页面，点击 Pull Request 按钮，目标分支选择 g1879/beta4 ，输入标题和必要的说明文字，右侧可补充一些可选内容比如相关联的 Issue，最后点击“创建 Pull Request”，完成申请，等待审核通过。

其他

1. 做好国际化发展是成为著名开源项目的必经之路，本文档的多语言化是未来的重要远景。以 Readme 文件为例，使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. DrissionPage 的作者是 Green ，几乎是单人开发。作者主页 https://gitee.com/g1879 ，欢迎关注，欢迎捐助
3. DrissionPage 首发 Gitee ，其官方博客为 blog.gitee.com，你可以访问 https://gitee.com/explore 这个地址来了解 Gitee 上的优秀开源项目
4. DrissionPage 已通过 GVP 项目认证。GVP 全称是 Gitee 最有价值开源项目 ，是综合评定出的优秀开源项目