Std ProjectUtil: Difference between revisions

From FreeCAD Documentation
(Removed 'In Progress'.)
(Marked this version for translation)
Line 2: Line 2:
<translate>
<translate>


<!--T:1-->
{{Docnav
{{Docnav
|[[Std_ExportGraphviz|Std ExportGraphviz]]
|[[Std_ExportGraphviz|Std ExportGraphviz]]
Line 11: Line 12:
}}
}}


<!--T:2-->
<!--Empty=1 to suppress icon-->
<!--Empty=1 to suppress icon-->
{{GuiCommand
{{GuiCommand
Line 19: Line 21:
}}
}}


==Description==
==Description== <!--T:3-->


<!--T:4-->
With the '''Std ProjectUtil''' command you can extract files from a FreeCAD project file (*.FCStd), which is in fact a [https://en.wikipedia.org/wiki/Zip_(file_format) ZIP] file, and, after manual edits, create a new project file from them.
With the '''Std ProjectUtil''' command you can extract files from a FreeCAD project file (*.FCStd), which is in fact a [https://en.wikipedia.org/wiki/Zip_(file_format) ZIP] file, and, after manual edits, create a new project file from them.


Line 26: Line 29:
[[Image:Project_utility_en.png]]
[[Image:Project_utility_en.png]]
<translate>
<translate>
<!--T:5-->
{{Caption|The Project utility dialog box}}
{{Caption|The Project utility dialog box}}


==Usage==
==Usage== <!--T:6-->


===Extract project===
===Extract project=== <!--T:7-->


<!--T:8-->
# Select the {{MenuCommand|Tools → Project utility...}} option from the menu.
# Select the {{MenuCommand|Tools → Project utility...}} option from the menu.
# The Project utility dialog box opens.
# The Project utility dialog box opens.
Line 41: Line 46:
# Press the {{Button|Close}} button to close the dialog box.
# Press the {{Button|Close}} button to close the dialog box.


===Manual edits===
===Manual edits=== <!--T:9-->


<!--T:10-->
It is important to realize that the files inside a FreeCAD project file are interlinked. Only editing a single file will typically lead to errors. To make consistent edits across multiple files use a good code editor, such as [http://notepad-plus-plus.org/ Notepad++] (for the Windows OS).
It is important to realize that the files inside a FreeCAD project file are interlinked. Only editing a single file will typically lead to errors. To make consistent edits across multiple files use a good code editor, such as [http://notepad-plus-plus.org/ Notepad++] (for the Windows OS).


===Create project===
===Create project=== <!--T:11-->


<!--T:12-->
# Select the {{MenuCommand|Tools → Project utility...}} option from the menu.
# Select the {{MenuCommand|Tools → Project utility...}} option from the menu.
# The Project utility dialog box opens.
# The Project utility dialog box opens.
Line 58: Line 65:
# Press the {{Button|Close}} button to close the dialog box.
# Press the {{Button|Close}} button to close the dialog box.


==Notes==
==Notes== <!--T:13-->


<!--T:14-->
* For more information about the FreeCAD project file format see [[File_Format_FCStd|File Format FCStd]].
* For more information about the FreeCAD project file format see [[File_Format_FCStd|File Format FCStd]].


<!--T:15-->
{{Docnav
{{Docnav
|[[Std_ExportGraphviz|Std ExportGraphviz]]
|[[Std_ExportGraphviz|Std ExportGraphviz]]

Revision as of 20:43, 3 May 2020

Std ProjectUtil

Menu location
Tools → Project utility...
Workbenches
All
Default shortcut
None
Introduced in version
-
See also
None

Description

With the Std ProjectUtil command you can extract files from a FreeCAD project file (*.FCStd), which is in fact a ZIP file, and, after manual edits, create a new project file from them.

The Project utility dialog box

Usage

Extract project

  1. Select the Tools → Project utility... option from the menu.
  2. The Project utility dialog box opens.
  3. Press the ... button to the right of Extract project → Source.
  4. Select the *.FCStd file you want to edit.
  5. Press the ... button to the right of Extract project → Destination.
  6. Select a folder where the project file should be extracted. It is advisable to select an empty folder.
  7. Press the Extract button.
  8. Press the Close button to close the dialog box.

Manual edits

It is important to realize that the files inside a FreeCAD project file are interlinked. Only editing a single file will typically lead to errors. To make consistent edits across multiple files use a good code editor, such as Notepad++ (for the Windows OS).

Create project

  1. Select the Tools → Project utility... option from the menu.
  2. The Project utility dialog box opens.
  3. Press the ... button to the right of Create project → Source.
  4. Select the 'Document.xml' file. The command will be automatically find all linked files.
  5. Press the ... button to the right of Create project → Destination.
  6. Select a folder where the new project file should be created.
  7. Press the Create button.
  8. A new project file with a fixed name, 'project.fcstd', is created in the selected folder. There is no warning if a file with that name already exists.
  9. Optionally check the Load project file after creation checkbox.
  10. Press the Close button to close the dialog box.

Notes