-
Notifications
You must be signed in to change notification settings - Fork 905
文档构建会导致 git 仓库产生大量文件改动 #6232
Copy link
Copy link
Open
Labels
PFCCPaddle Framework Contributor Club,https://github.com/PaddlePaddle/community/tree/master/pfccPaddle Framework Contributor Club,https://github.com/PaddlePaddle/community/tree/master/pfcc
Metadata
Metadata
Assignees
Labels
PFCCPaddle Framework Contributor Club,https://github.com/PaddlePaddle/community/tree/master/pfccPaddle Framework Contributor Club,https://github.com/PaddlePaddle/community/tree/master/pfcc
Type
Fields
Give feedbackNo fields configured for issues without a type.
文档链接&描述 Document Links & Description
按照教程构建文档后,将产生大约 10000+ 改动的文件。
其中:
output/新增,由于该路径未位于.gitignore中,因此未忽略;docs/api/paddle/*_cn.rst中COPY-FROM块的更新docs/practices和docs/guides中,ipynb被移除,构建为新增的md和png这部分的构建后改动会导致每次构建破坏原有的仓库文件信息,从而不利于在开发文档时构建测试。
在更极端情况中,如果进行修改后,未提交更改就进行了构建,则其修改内容很可能被覆盖或丢失,从而增加修改成本。
请提出你的建议/提个PR修复这个问题 Please give your suggestion/update a PR to fix it
对于
output与英文文档部分,已添加gitignore解决 #6231其余中文文档更新与
ipynb部分,尚未解决,或许需要添加临时目录以供构建等,如添加build目录,复制所有要改动的文件到其中完成改动。附1 构建命令不明确:README 教程中的构建指引,采用
bash docs-build.sh -f absolute_path_docs方法,略显不直观,能否考虑基于docs-build.sh计算路径,或使用pwd等方法直接获取,避免这里造成不确定填<PROJECT_ROOT>/docs还是<PROJECT_ROOT>附2 权限非预期:构建过程由于基于
docker进行,生成的文件都是root用户所有的,导致低权限状态下无法修改、删除相关文件附3 临时绕开文件变动方法:
rm -rf output/ docs/api/paddle/ docs/guides/ docs/inference_api/ docs/practices/ # 需要 root 权限 git reset HEAD --hard@sunzhongkai588 @SigureMo