Main Page: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(197 intermediate revisions by 36 users not shown)
Line 1: Line 1:
__NOTOC__
<div style="border:0; margin: 0.2em 10px 10px;">
<languages/>
<div style="background:#f9f9f9; padding:0px; border:1px solid #aaaaaa; margin-bottom:5px;">
<translate>
<div style="line-height:120%; padding:0.4em; background-color:#eeeeee; border-bottom:1px solid #aaaaaa;">
<span style="color:#cf7606; font-size:200%;">'''Welcome to'''&nbsp;</span><span style="color:#005288; font-size:200%;">'''FreeCAD'''</span>
</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">


<!--T:1-->
{| style="border: 0; margin: 0;" cellpadding="3"
== Introduction ==
| valign="top" |
This is the documentation wiki of [http://www.freecadweb.org FreeCAD]. There are several ways to use this documentation: by exploring the hubs, by following the manual, or by using the Help menu entries from within FreeCAD. This is a work in progress, written by the community of users and developers of FreeCAD. If you find information that is wrong or missing, please [[Special:MyLanguage/help_FreeCAD|help FreeCAD]]!
{{Clear}}


== The hubs == <!--T:3-->
'''FreeCAD''' will be a general purpose 3D [http://en.wikipedia.org/wiki/CAD '''CAD'''] modeler. The development is completely [http://en.wikipedia.org/wiki/Open_source Open Source] (GPL & LGPL License). FreeCAD is aimed directly at [http://en.wikipedia.org/wiki/Mechanical_engineering mechanical engineering] and [http://en.wikipedia.org/wiki/Product_design product design] but also fits in a wider range of uses around engineering, such as architecture or other engineering specialties.


<!--T:4-->
FreeCAD features tools similar to [http://en.wikipedia.org/wiki/Catia Catia], [http://en.wikipedia.org/wiki/Solidworks SolidWorks] or [http://en.wikipedia.org/wiki/Solid_Edge Solid Edge], and therefore also falls into the category of [http://en.wikipedia.org/wiki/CAD '''MCAD'''], [http://en.wikipedia.org/wiki/Product_Lifecycle_Management '''PLM'''], [http://en.wikipedia.org/wiki/CAx '''CAx'''] and [http://en.wikipedia.org/wiki/Computer-aided_engineering '''CAE''']. It will be a [http://en.wikipedia.org/wiki/Parametric_feature_based_modeler feature based parametric modeler] with a modular software architecture which makes it easy to provide additional functionality without modifying the core system. [[About FreeCAD|Learn more...]]
[[Image:Crystal_Clear_app_display.png|64px|left]] [[User_hub|Users hub]]: This page contains documentation useful for FreeCAD users in general: a list of all the workbenches, detailed instructions on how to install and use the FreeCAD application, tutorials, and all you need to get started.
{{Clear}}
[[Image:Crystal Clear app terminal.png|64px|left]] [[Power_users_hub|Power users hub]]: This page gathers documentation for advanced users and people interested in writing Python scripts. There you will also find a repository of macros, instructions on how to install and use them, and more information about customizing FreeCAD to your specific needs.
{{Clear}}
[[Image:Crystal Clear app tutorials.png|64px|left]] [[Developer_hub|Developers hub]]: This section contains material for developers: How to compile FreeCAD yourself, how the FreeCAD source code is structured, how to navigate the source code, how to develop new workbenches, and embed FreeCAD in your own application.
{{Clear}}


== Manual == <!--T:5-->
{{Template:Download|Version=0.8|Release=2237}}
For other systems: see the [http://sourceforge.net/project/showfiles.php?group_id=49159 Downloads] page.
| valign="top" |
{{Click | image=FreeCAD_Screenshot.png | link=Screenshots | width=300px| height=221px}}
|}


<!--T:14-->
[[Image:Crystal_Clear_manual.png|64px|left]] [[Manual:Introduction|The FreeCAD manual]] is another, more linear way to present the information contained in this wiki. It is designed to be read like a book, and will gently introduce you to many other pages from the hubs above. [https://www.gitbook.com/book/yorikvanhavre/a-freecad-manual/details ebook versions] are also available, as well as [https://www.freecadweb.org/manual/ a couple of translations in pdf format].
{{Clear}}


== Table of contents == <!--T:15-->
</div>
{| style="zborder-top:1px solid #aaaaaa;" width="100% border-collapse: collapse;" cellpadding=0 cellspacing=0
|- align="center" valign="top"
| style="padding: 0.2em;" width="25%" |
'''[[Download]]'''
&nbsp; | &nbsp;
'''[[Screenshots]]'''
&nbsp; | &nbsp;
'''[[Help|Help & Support]]'''
&nbsp; | &nbsp;
'''[http://apps.sourceforge.net/phpbb/free-cad/index.php Forum]'''
&nbsp; | &nbsp;
'''[[About this site]]'''


<!--T:6-->
The Table of contents is available in several languages:
</translate>
{|border="0" width="100%" style="background:transparent;"
|-
|
* [[Image:Flag-en.jpg]] [[Online Help Toc|Table of contents]]
* [[Image:Flag-bg.jpg]] [[Online Help Toc/bg|Съдържание]]
* [[Image:Flag-cn.jpg‎]] [[Online_Help_Toc/zh|目錄]] zh
* [[Image:Flag-cn.jpg]] [[Online Help Toc/zh-cn|目录]] zh-cn
* [[Image:Flag-cn.jpg‎]] [[Online_Help_Toc/zh-tw|目錄]] zh-tw
* [[Image:Flag-cs.jpg]] [[Online Help Toc/cs|Obsah]]
* [[Image:Flag-de.jpg]] [[Online Help Toc/de|Inhaltsverzeichnis]]
* [[Image:Flag-es.jpg]] [[Online Help Toc/es|Índice de contenidos]]
||
* [[Image:Flag-fr.jpg]] [[Online Help Toc/fr|Table des matières]]
* [[Image:Flag-hr.jpg]] [[Online Help Toc/hr|Sadržaj]]
* [[Image:Flag-id.jpg]] [[Online Help Toc/id|Daftar isi]]
* [[Image:Flag-it.jpg]] [[Online Help Toc/it|Sommario]]
* [[Image:Flag-jp.jpg]] [[Online Help Toc/ja|目次]] ja
* [[Image:Flag-ko.jpg]] [[Online Help Toc/ko|온라인 도움말]]
* [[Image:Flag-pl.jpg]] [[Online Help Toc/pl|Spis Treści]]
||
* [[Image:Flag-pt.jpg]] [[Online Help Toc/pt|Tabela de conteúdos]] pt
* [[Image:Flag-pt-br.jpg]] [[Online Help Toc/pt-br|Índice]] pt-br
* [[Image:Flag-ro.jpg]] [[Online_Help_Toc/ro|Cuprins]]
* [[Image:Flag-ru.jpg]] [[Online Help Toc/ru|Содержание]]
* [[Image:Flag-sv.jpg]] [[Online Help Toc/sv|Innehallsforteckning]]
* [[Image:Flag-tr.jpg]] [[Online Help Toc/tr|İçindekiler]]
* [[Image:Flag-uk.jpg]] [[Online Help Toc/uk|Вміст]]
|}
|}
<translate>
</div>
</div>
{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#eeeeee; border-bottom:1px solid #aaaaaa; text-align: center;">'''[[User hub|Users documentation]]'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | {{Click | image=Crystal_Clear_app_display.png | link=User hub | width=80px| height=80px}}
| valign="top" |
* [[Tutorials]]
* [[Online_Help_Toc|Manual]]
* [[Workbenches|Workbench documentation]]
* '''[[User hub|More]]'''
|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#eeeeee; border-bottom:1px solid #aaaaaa; text-align: center;">'''[[Power users hub|Power users documentation]]'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | {{Click |image=Crystal_Clear_app_terminal.png | link=Power users hub | width=80px| height=80px}}
| valign="top" |
* [[Interface Customization|Customizing]]
* [[Scripting]]
* [[Topological_data_scripting|CAD data scripting]]
* '''[[Power users hub|More]]'''
|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#eeeeee; border-bottom:1px solid #aaaaaa; text-align: center;">'''[[Developer hub|Developers documentation]]'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | {{Click | image=Crystal_Clear_app_tutorials.png | link=Developer hub | width=80px| height=80px}}
| valign="top" |
* [[CompileOnWindows|Compiling on Windows]]
* [[CompileOnUnix|Compiling on Unix]]
* [[CompileOnMac|Compiling on Mac]]
* [[License]]
* '''[[Developer hub|More]]'''
|}</div>
|}
{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0px; border:1px solid #aaaaaa; margin-bottom:15px;" |<div style="font-size:105%; line-height:120%; padding:0.4em; background-color:#eeeeee; border-bottom:1px solid #aaaaaa;">
[[Image:Exquisite-khelpcenter.png|right|20px|Info icon]]'''News'''
</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em; font-size:95%;">
{{FreeCAD News}}
* '''[[News|Older news...]]'''
</div>
| valign="top" style="width: 17em; margin-bottom:5px; padding: 0; border:1px solid #aaaaaa;"|<div style="font-size:105%; line-height:120%; padding: 0.4em; background-color:#eeeeee; border-bottom:1px solid #aaaaaa;">
[[Image:Crystal 128 down.png|right|18px|Download]] '''[[Download|Latest downloads]]'''
</div>
<div style="padding:0.4em; font-size: 95%;">
*[http://sourceforge.net/project/downloading.php?group_id=49159&filename=FreeCAD_0.7.2072_installer.msi Windows installer]
*[http://sourceforge.net/project/downloading.php?group_id=49159&filename=freecad_0.7.2008-1jaunty1_i386.deb Ubuntu package]
*[http://sourceforge.net/project/downloading.php?group_id=49159&filename=FreeCAD_0.7.2072_helpfile.chm User manual]
*[http://sourceforge.net/project/downloading.php?group_id=49159&filename=FreeCAD_0.7.2008_source.zip Source code]
*[http://sourceforge.net/project/downloading.php?group_id=49159&filename=FreeCADLibs6.2.zip LibPack]
*[http://sourceforge.net/project/showfiles.php?group_id=49159 All FreeCAD downloads]


== Get involved == <!--T:7-->
</div>

|}
=== How to participate === <!--T:8-->

<!--T:9-->
There is plenty to do inside the FreeCAD project, if you are interested in helping us. Of course, there are programming tasks for C++ or Python programmers, but there are also many things you can do even if you cannot code, such as
* writing documentation and [[WikiPages|editing the wiki (en)]]
* helping newcomers
* translating the application and documentation
* helping with the packaging of the latest release of FreeCAD for your favourite operating system
* helping other people around you to discover FreeCAD.

<!--T:16-->
The [[Special:MyLanguage/help_FreeCAD|help FreeCAD]] page describes it all with more details. Starting from 2016, FreeCAD also participates in the [[Google_Summer_of_Code|Google Summer of Code]].

=== Source code === <!--T:10-->

<!--T:11-->
FreeCAD can be compiled on all platforms using [https://cmake.org/ CMake]. The source code is [https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License LGPL]-licensed and hosted on [https://github.com/FreeCAD/FreeCAD GitHub] and mirrored on [https://gitlab.com/freecad/FreeCAD GitLab], [https://sourceforge.net/projects/free-cad/ SourceForge] and [https://codeberg.org/FreeCAD/FreeCAD CodeBerg]. There are build instructions for [[Compile_on_Windows|Windows]], [[Compile_on_Linux|Linux]] and [[Compile_on_MacOS|MacOS]]. The source code documentation is [http://www.freecadweb.org/api/ hosted here], generated by [[Doxygen|Doxygen]], and [[Source_documentation|documented on the wiki]].

=== About the development === <!--T:12-->

<!--T:13-->
Check the [[Development roadmap|Development roadmap]] for news about what is being planned, the [http://www.freecadweb.org/tracker/changelog_page.php Changelog] and [http://www.freecadweb.org/tracker/roadmap_page.php Roadmap] pages on the [http://www.freecadweb.org/tracker FreeCAD tracker] to see the progress towards next release, or the [http://www.ohloh.net/p/freecad Project statistics] for even more information about the FreeCAD codebase. All the development communication happens on the [http://forum.freecadweb.org forum], so be sure to visit it if you are interested in participating.


</translate>
{{Userdocnavi{{#translation:}}}}
[[Category:Documentation{{#translation:}}]]

Latest revision as of 21:46, 18 September 2023

Introduction

This is the documentation wiki of FreeCAD. There are several ways to use this documentation: by exploring the hubs, by following the manual, or by using the Help menu entries from within FreeCAD. This is a work in progress, written by the community of users and developers of FreeCAD. If you find information that is wrong or missing, please help FreeCAD!

The hubs

Users hub: This page contains documentation useful for FreeCAD users in general: a list of all the workbenches, detailed instructions on how to install and use the FreeCAD application, tutorials, and all you need to get started.

Power users hub: This page gathers documentation for advanced users and people interested in writing Python scripts. There you will also find a repository of macros, instructions on how to install and use them, and more information about customizing FreeCAD to your specific needs.

Developers hub: This section contains material for developers: How to compile FreeCAD yourself, how the FreeCAD source code is structured, how to navigate the source code, how to develop new workbenches, and embed FreeCAD in your own application.

Manual

The FreeCAD manual is another, more linear way to present the information contained in this wiki. It is designed to be read like a book, and will gently introduce you to many other pages from the hubs above. ebook versions are also available, as well as a couple of translations in pdf format.

Table of contents

The Table of contents is available in several languages:

Get involved

How to participate

There is plenty to do inside the FreeCAD project, if you are interested in helping us. Of course, there are programming tasks for C++ or Python programmers, but there are also many things you can do even if you cannot code, such as

  • writing documentation and editing the wiki (en)
  • helping newcomers
  • translating the application and documentation
  • helping with the packaging of the latest release of FreeCAD for your favourite operating system
  • helping other people around you to discover FreeCAD.

The help FreeCAD page describes it all with more details. Starting from 2016, FreeCAD also participates in the Google Summer of Code.

Source code

FreeCAD can be compiled on all platforms using CMake. The source code is LGPL-licensed and hosted on GitHub and mirrored on GitLab, SourceForge and CodeBerg. There are build instructions for Windows, Linux and MacOS. The source code documentation is hosted here, generated by Doxygen, and documented on the wiki.

About the development

Check the Development roadmap for news about what is being planned, the Changelog and Roadmap pages on the FreeCAD tracker to see the progress towards next release, or the Project statistics for even more information about the FreeCAD codebase. All the development communication happens on the forum, so be sure to visit it if you are interested in participating.