此项目致力于帮助大家更好的理解和快速上手 Jetpack Compose 框架,从而提高开发效率
有问题欢迎提交 issue 来提问
—————————————————————
有 Codelabs 用于学习一些有意思的东西(作者太菜于是没做了...)
欢迎来学习!
基础文档:
代码实验室:
https://codelabs.compose.net.cn
如果你想为 Jetpack Compose 做贡献的话,你可以加入 Kotlin 的 Slack 频道 #Compose, 或者在 https://issuetracker.google.com/issues?q=componentid:612128 中提交 Compose 的 Bug 或者错误
我们非常欢迎各种的 PR 请求(包括但不局限于添加一个换行增加阅读体验),_(:з)∠)_本项目还处于初期阶段,非常需要各位大佬的完善和纠错
如果你有已经写好的文章想要添加到这里,欢迎发送 Markdown 格式的文件给我们!
文档采用 Material 主题的 MkDocs 来编辑,非常好上手,你只需要按照以下的步骤:
- 安装插件
pip install mkdocs-material
pip install mkdocs-git-revision-date-localized-plugin
pip install mkdocs-macros-plugin
-
在本地运行和测试
在项目根目录终端执行
mkdocs serve
,将会在http://localhost:8000/
看到文档 -
如何添加/更改文档?
文档都是由 Markdown 语法来编写的,所有文档位于 /docs 中, 如果需要扩展左边的导航侧栏,请在 mkdocs.yml 更新 nav
图片添加需要在 /assets/ 下,和文档同等路径名字添加, 例如如果我修改了 Text 的文档,并且添加了一张例图 那么就是放在 /assets/elements/text/xxx.png
调用的时候使用宏定义,详情可以参考其他文档中调用
img
标签或者markdown
调用图片语句中的config.assets
-
最后
恭喜你,当你同步了本项目的最新进度并且添加了你所想的东西,你只需要提交 PR 即可,我们在审核通过会自动同步到网站上
首先,您需要 fork
一份本项目,然后同步项目的最新进度:
在 github 网页中,在你的 fork 仓库里,点击 Fetch upstream
然后在项目根目录执行
git pull origin main
... // 写新内容
git push // push 到自己的分支
pr // 在网页上提交 PR
git remote add fork [email protected]:compose-museum/compose-tutorial.git (或使用 HTTPS)
git remote -v
git fetch fork //同步项目最新进度
git merge fork/main //合并项目最新进度
... // 写新内容
git push // push 到自己的分支
pr // 在网页上提交 PR
MIT License
Copyright (c) 2021 Compose-Museum
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.