[Bf-docboard-svn] bf-manual: [8088] branches/blender-2.93-release/blender_docs/manual: Blend Files: Update open/save layout
Aaron Carlisle
noreply at blender.org
Tue May 25 23:07:49 CEST 2021
Revision: 8088
https://developer.blender.org/rBM8088
Author: Blendify
Date: 2021-05-25 23:07:49 +0200 (Tue, 25 May 2021)
Log Message:
-----------
Blend Files: Update open/save layout
Modified Paths:
--------------
branches/blender-2.93-release/blender_docs/manual/files/blend/open_save.rst
branches/blender-2.93-release/blender_docs/manual/interface/window_system/topbar.rst
Modified: branches/blender-2.93-release/blender_docs/manual/files/blend/open_save.rst
===================================================================
--- branches/blender-2.93-release/blender_docs/manual/files/blend/open_save.rst 2021-05-25 18:33:23 UTC (rev 8087)
+++ branches/blender-2.93-release/blender_docs/manual/files/blend/open_save.rst 2021-05-25 21:07:49 UTC (rev 8088)
@@ -19,19 +19,11 @@
of the *Preferences*.
-.. _files-blend-open:
+.. _bpy.ops.wm.open_mainfile:
Opening Files
=============
-.. figure:: /images/files_blend_open-save_file-browser-open.png
-
- The File Browser in open configuration.
-
-
-Usage
------
-
.. admonition:: Reference
:class: refbox
@@ -41,7 +33,10 @@
The upper text field displays the current directory path,
and the lower text field contains the selected filename.
+.. figure:: /images/files_blend_open-save_file-browser-open.png
+ The File Browser in open configuration.
+
Options
-------
@@ -66,43 +61,79 @@
.. _other-file-open-options:
-Other File Open Options
------------------------
+Open Recent
+===========
-From the *File* menu, you can also open files with the following tools:
+.. admonition:: Reference
+ :class: refbox
-Open Recent
- Lists recently used files. Click on one to load it in.
-Recover Last Session
- This will load the ``quit.blend`` file Blender automatically saved just before exiting.
- This option enables you to recover your last work session if, for example, you closed Blender by accident.
-Recover Auto Save
- This will allow you to open an automatically saved file to recover it.
+ :Menu: :menuselection:`File --> Open Recent`
+ :Shortcut: :kbd:`Shift-Ctrl-O`
+Lists recently used files. Click on one to load it in.
+
+
+Recover
+=======
+
.. seealso::
:ref:`Auto Saves <troubleshooting-file-recovery>`
+.. _bpy.ops.wm.recover_last_session:
-.. _files-blend-save:
+Last Session
+------------
-Saving Files
-============
+.. admonition:: Reference
+ :class: refbox
-.. figure:: /images/files_blend_open-save_file-browser-save.png
+ :Menu: :menuselection:`File --> Recover --> Last Session`
- The File Browser in save configuration.
+This will load the ``quit.blend`` file Blender automatically saved just before exiting.
+This option enables you to recover your last work session if, for example, you closed Blender by accident.
-Usage
------
+.. _bpy.ops.wm.recover_auto_save:
+Auto Save
+---------
+
.. admonition:: Reference
:class: refbox
+ :Menu: :menuselection:`File --> Recover --> Auto Save`
+
+This will allow you to open an automatically saved file to recover it.
+
+
+.. _bpy.ops.wm.save_mainfile:
+
+Saving Files
+============
+
+.. admonition:: Reference
+ :class: refbox
+
:Menu: :menuselection:`File --> Save`
:Shortcut: :kbd:`Ctrl-S`
+Save current blend-file over itself (if it was not saved yet, this will automatically switch to *Save As...*).
+
+.. figure:: /images/files_blend_open-save_file-browser-save.png
+
+ The File Browser in save configuration.
+
+.. seealso::
+
+ :ref:`Auto Save <troubleshooting-file-recovery>`
+
+
+.. _bpy.ops.wm.save_as_mainfile:
+
+Save As
+=======
+
.. admonition:: Reference
:class: refbox
@@ -109,21 +140,8 @@
:Menu: :menuselection:`File --> Save As...`
:Shortcut: :kbd:`Shift-Ctrl-S`
-.. admonition:: Reference
- :class: refbox
+Choose a file path to save the blend-file to.
- :Menu: :menuselection:`File --> Save Copy...`
-
-There are a number of slightly different methods you can use to save your blend-file to your drive:
-
-Save :kbd:`Ctrl-S`
- Save current blend-file over itself (if it was not saved yet, this will automatically switch to *Save As...*).
-Save As... :kbd:`Shift-Ctrl-S`
- Choose a file path to save the blend-file to.
-Save Copy
- Choose a file path to save the blend-file to, but return to editing the original file upon completion.
- This can be used to save backups of the current working state without modifying the original file.
-
.. warning::
If a file with the same given name already exists,
@@ -151,11 +169,8 @@
This option may slow down Blender when you quit,
or under normal operation when Blender is saving your backup files.
+ See :ref:`files-linked_libraries-known_limitations-compression` for more information.
- .. seealso::
-
- Linked Libraries :ref:`files-linked_libraries-known_limitations-compression`.
-
Remap Relative
This option remaps :ref:`files-blend-relative_paths`
(such as linked libraries and images) when saving a file in a new location.
@@ -162,11 +177,21 @@
Save Copy
This option saves a copy of the actual working state but does not make the saved file active.
-.. seealso::
- :ref:`Auto Save <troubleshooting-file-recovery>`
+Save Copy
+=========
+.. admonition:: Reference
+ :class: refbox
+ :Menu: :menuselection:`File --> Save Copy...`
+
+Choose a file path to save the blend-file to, but return to editing the original file upon completion.
+This can be used to save backups of the current working state without modifying the original file.
+
+For options see :ref:`bpy.ops.wm.save_as_mainfile`.
+
+
.. _files-blend-relative_paths:
Relative Paths
@@ -199,5 +224,5 @@
.. hint::
If it is necessary to relocate a blend-file relative to its linked resources,
- use Blender's File :ref:`Save As... <files-blend-save>`
+ use Blender's File :ref:`Save As... <bpy.ops.wm.save_mainfile>`
function which has an option to *Remap Relative* file links.
Modified: branches/blender-2.93-release/blender_docs/manual/interface/window_system/topbar.rst
===================================================================
--- branches/blender-2.93-release/blender_docs/manual/interface/window_system/topbar.rst 2021-05-25 18:33:23 UTC (rev 8087)
+++ branches/blender-2.93-release/blender_docs/manual/interface/window_system/topbar.rst 2021-05-25 21:07:49 UTC (rev 8088)
@@ -53,7 +53,7 @@
New :kbd:`Ctrl-N`
Clears the current scene and loads the selected application template.
Open :kbd:`Ctrl-O`
- :ref:`Open <files-blend-open>` a blend-file.
+ :ref:`Open <bpy.ops.wm.open_mainfile>` a blend-file.
Open Recent :kbd:`Shift-Ctrl-O`
Displays a list of :ref:`recently <other-file-open-options>` saved blend-files to open.
Revert
@@ -67,11 +67,11 @@
This will open an automatically saved file
to :doc:`recover </troubleshooting/recover>` it.
Save :kbd:`Ctrl-S`
- :ref:`Save <files-blend-save>` the current blend-file.
+ :ref:`Save <bpy.ops.wm.save_mainfile>` the current blend-file.
Save As... :kbd:`Shift-Ctrl-S`
- Opens the File Browser to specify file name and location of :ref:`save <files-blend-save>`.
+ Opens the File Browser to specify file name and location of :ref:`save <bpy.ops.wm.save_mainfile>`.
Save Copy...
- :ref:`Saves <files-blend-save>` a copy of the current file.
+ :ref:`Saves <bpy.ops.wm.save_mainfile>` a copy of the current file.
Link...
Links data from an external blend-file (library) to the current scene.
The edition of that data is only possible in the external library.
More information about the Bf-docboard-svn
mailing list