FreeCAD模块开发指南 前言

Chinese forum

Moderator: paullee

Forum rules
论坛规矩 / 論壇規矩 , 有用的资讯 / 有用的資訊
重要:寻求帮助之前,请先看看这里 /
重要:尋求幫助之前,請先看看這裡

另外,对论坛用户 友善!阅读FreeCAD 行为准则!
/ 另外,對論壇用戶 友善! 閱讀FreeCAD
行為準則
Post Reply
TobyGu
Posts: 7
Joined: Fri Dec 18, 2020 2:17 pm

FreeCAD模块开发指南 前言

Post by TobyGu »

大家好,我是一名机械设计人员,长久以来一直梦想有一款理想中的设计软件,最近看到FreeCAD, 很高兴与大家交流,这篇帖子就是我的投名状!

由于是做机械设计的,对软件编程不是很了解,想要学习一下。正好看到了这本Github上的书,貌似没有中文版,因此决定尝试翻译,顺便学习软件编程知识,提高自己。

小白翻译,请大家多多指教!

本文首发于我的简书https://www.jianshu.com/p/613f5cd35cdc
翻译开始

FreeCAD模块开发指南

作者 Qingfeng Xia 2016

作者 Luzpaz 2019

可从pdf文件夹下载最新版本

修订日志
- 2015-0918 0.1版 用于FreeCAD 0.16-dev版

- 2016-09-18 0.2版 用于FreeCAD 0.17-dev版

- 2019-06-18 再版目标 0.3版 用于FreeCAD 0.19-dev版

计划与进度
本书随(FreeCAD)最新版本的发布而更新,尤其是在迁移到Python3 + Pyside2之后。我计划于圣诞节前后为FreeCAD 0.19发布最新版。

本书许可证
类似FreeCAD文档许可证为CC-BY 3.0

本书许可证为 署名-相同方式共享 4.0 国际共享许可证(Attribution-ShareAlike 4.0 International)

全文请参阅此库中的文件以及在线版https://creativecommons.org/licenses/by-sa/4.0/。简而言之,此许可证允许您:

共享- 通过任何媒介和任何形式复制、转载本作品 。

改变- 在任意用途下合成、转换和改造本作品,包括商业性的。

只要求您:共享您的衍生作品(相同方式共享)并归功于作者(署名)。

致谢FreeCAD开发者
原始/主要开发者:

* Jürgen Riegel

* Werner Mayer

* yorik van havre

其他所有贡献者,请参见https://www.freecadweb.org/wiki/Contributors

目标读者:新模块开发者
确保身为用户的您熟悉FreeCAD工作台图形用户界面(GUI)和应用程序接口(API):

* FreeCAD官方维基上的基础文档。

* FreeCAD python API 文档

* 单个文件PDF用户手册,用于快速入门

Doxygen 文档链接
Doxygen 生成的在线文档源于0.16dev版,将很快删除

Doxygen 于2019-06-24生成的在线文档源于0.19dev版

我为什么要写这本书
* 了解FreeCAD的软件架构:一个大型开源项目

* 了解如何使用git为像FreeCAD这样的开源项目做出贡献

* 为新开发者探索FreeCAD源代码节省时间

* 在为FreeCAD编写/贡献代码时,记录个人笔记和教训

* 经审查可用后,希望本书的某些章节能合并到官方维基中

我的研究:“自动化及智能工程设计”

如何为本书做贡献
* 撰写未完成的主题/章节(列在todo.md分支中),并请求`git clone https://github.com/qingfengxia/FreeCAD_ ... _Guide.git`。

* 为过时的代码分析报告错误。由于本书在代码分析时,FreeCAD正在进行深度开发,因此引用的源代码可能会很快过时。请在这个github问题板中指出我的报告错误之处。

* 本书使用python脚本进行预处理,请在脚本文件夹的Readme中查看详情。有一些锚文本,例如:

* [src/*.h/cpp]被处理为链接到最新的官方FreeCAD源。

* 其他一些锚文本"## folders ... ",将很快被更明确地标记出来。

向我的家人致谢
直到2019年时,此项工作尚未获得我的雇主们(牛津大学,英国原子能局)的资助。这是一项社区志愿工作,感谢每一条评论,均为本书做出了贡献。

Qingfeng Xia 感谢我的妻子J.Wang女士,以及其他家庭成员,让我免除家务活来完成这项工作。

版权声明:本文翻译自《Module developer's guide to FreeCAD source code》,遵循 CC 4.0 BY-SA 协议(https://creativecommons.org/licenses/by-sa/4.0/),转载请附上原文出处链接及本声明。原文链接:https://github.com/qingfengxia/FreeCAD_Mod_Dev_Guide
paullee
Veteran
Posts: 5098
Joined: Wed May 04, 2016 3:58 pm

Re: FreeCAD模块开发指南 前言

Post by paullee »

TobyGu wrote: Sat Dec 26, 2020 12:42 pm 大家好,我是一名机械设计人员,长久以来一直梦想有一款理想中的设计软件,最近看到FreeCAD, 很高兴与大家交流,这篇帖子就是我的投名状!

由于是做机械设计的,对软件编程不是很了解,想要学习一下。正好看到了这本Github上的书,貌似没有中文版,因此决定尝试翻译,顺便学习软件编程知识,提高自己。

小白翻译,请大家多多指教!

本文首发于我的简书https://www.jianshu.com/p/613f5cd35cdc
翻译开始

FreeCAD模块开发指南

作者 Qingfeng Xia 2016

作者 Luzpaz 2019

很高興有更多人幫忙FC開發工作 :D

Ping 一下 其它人員 (ping 中文怎麼說 ? :lol: ) 武克特(@kkremitzki) 是核心開發人員,看懂/在學 中文。不知 Qingfeng Xia 是否在這論壇上?

Kunda1 wrote: Ping
kkremitzki wrote: Ping
realthunder wrote: Ping
realthunder
Veteran
Posts: 2190
Joined: Tue Jan 03, 2017 10:55 am

Re: FreeCAD模块开发指南 前言

Post by realthunder »

qingfeng.xia wrote: ping
Qingfeng Xia也是中国人,可能已经有中文翻译了
Try Assembly3 with my custom build of FreeCAD at here.
And if you'd like to show your support, you can donate through patreon, liberapay, or paypal
TobyGu
Posts: 7
Joined: Fri Dec 18, 2020 2:17 pm

Re: FreeCAD模块开发指南 前言

Post by TobyGu »

realthunder wrote: Wed Dec 30, 2020 4:23 am
qingfeng.xia wrote: ping
Qingfeng Xia也是中国人,可能已经有中文翻译了
啊,是吗,中文版在哪呀,我问了一圈没人回应才自己动手的,现在刚开始,如果有了麻烦告诉我在哪哦。
qingfeng.xia
Posts: 227
Joined: Tue Sep 22, 2015 1:47 pm
Location: Oxford UK/Shenzhen China
Contact:

Re: FreeCAD模块开发指南 前言

Post by qingfeng.xia »

Sorry , very busy in coping Covid19 lockdown. to look at forum message.

FreeCAD module dev guide is not quite completed, so I have not even plan ned to translate back to Chinese.
Effort for translation is welcomed, if any outdated code, please file issue on the github ~

Thank you
Ubuntu 18.04 LTS 64bit, python3, always work with latest FreeCAD daily build
Working on Cfd module for FreeCAD, FreeCAD_Module_Develop_Guide
https://github.com/ukaea/parallel-preprocessor/
https://github.com/qingfengxia/Cfd
Andy_Suen
Posts: 4
Joined: Wed Jan 13, 2021 3:15 am

Re: FreeCAD模块开发指南 前言

Post by Andy_Suen »

请问什么时候更新,我是初级开发者,需要掌握 哪些知识可以快速开发
User avatar
johnwang
Veteran
Posts: 1345
Joined: Sun Jan 27, 2019 12:41 am

Re: FreeCAD模块开发指南 前言

Post by johnwang »

Andy_Suen wrote: Sun Jan 31, 2021 8:03 am 请问什么时候更新,我是初级开发者,需要掌握 哪些知识可以快速开发
会Python就可以了。从写宏开始。
hfc series CAE workbenches for FreeCAD (hfcNastran95, hfcMystran, hfcFrame3DD, hfcSU2 and more)
TobyGu
Posts: 7
Joined: Fri Dec 18, 2020 2:17 pm

Re: FreeCAD模块开发指南 前言

Post by TobyGu »

Andy_Suen wrote: Sun Jan 31, 2021 8:03 am 请问什么时候更新,我是初级开发者,需要掌握 哪些知识可以快速开发
不好意思,最近过年,好久没更新,计划等过完年恢复,谢谢!
Post Reply