[Bf-docboard-svn] bf-manual: [8414] trunk/blender_docs/manual/editors/file_browser.rst: File Browser: Update Document Layout
Aaron Carlisle
noreply at blender.org
Wed Sep 22 05:39:33 CEST 2021
Revision: 8414
https://developer.blender.org/rBM8414
Author: Blendify
Date: 2021-09-22 05:39:32 +0200 (Wed, 22 Sep 2021)
Log Message:
-----------
File Browser: Update Document Layout
Modified Paths:
--------------
trunk/blender_docs/manual/editors/file_browser.rst
Modified: trunk/blender_docs/manual/editors/file_browser.rst
===================================================================
--- trunk/blender_docs/manual/editors/file_browser.rst 2021-09-21 23:38:11 UTC (rev 8413)
+++ trunk/blender_docs/manual/editors/file_browser.rst 2021-09-22 03:39:32 UTC (rev 8414)
@@ -29,19 +29,15 @@
The File Browser.
-Header
-======
+Interface
+=========
-View Menu
----------
+Header Region
+-------------
-Select
-------
+File Path Region
+----------------
-
-File Path
-=========
-
.. _bpy.ops.file.previous:
Previous Folder :kbd:`Backspace`, :kbd:`Alt-Left`
@@ -94,9 +90,8 @@
:Thumbnails: Shows :ref:`previews <file_browser-previews>`.
-
Display Settings
-----------------
+^^^^^^^^^^^^^^^^
.. _bpy.types.FileSelectParams.display_size:
@@ -143,7 +138,7 @@
.. _bpy.types.FileSelectParams.use_filter:
Filter Settings
----------------
+^^^^^^^^^^^^^^^
On the right side of the file path are the filtering options.
The first "funnel" button controls whether filtering is enabled or not.
@@ -162,8 +157,8 @@
Shows hidden files (starting with a ``.``).
-File Name & Execution
-=====================
+Execution Region
+----------------
.. _bpy.types.FileSelectParams.filename:
@@ -190,8 +185,8 @@
Double-clicking on a non-directory item will have the same effect.
-Source List
-===========
+Source List Region
+------------------
The left region displays different ways to quickly access some directories.
The region is divided into separate panels each containing a :ref:`UI List <ui-list-view>` of directories.
@@ -239,8 +234,8 @@
of the :ref:`Save & Load <prefs-save-load>` tab in the Preferences.
-Operator Options
-================
+Operator Options Region
+-----------------------
The right region shows the options of the calling operator.
Besides common actions listed below, many import/export add-ons will also expose their options there.
@@ -259,11 +254,30 @@
Main Region
-===========
+-----------
-Navigation
-----------
+.. _file_browser-previews:
+Previews
+^^^^^^^^
+
+.. figure:: /images/editors_file-browser_previews.png
+
+ The File Browser in *Thumbnail* mode.
+
+In its *Thumbnail* display mode, the File Browser supports many types of previews. These include:
+
+- Image and video formats
+- Fonts
+- Blend-files
+- Internal :doc:`Data-blocks </files/data_blocks>`
+
+See :doc:`Blend-files Previews </files/blend/previews>` for how to manage Blender data previews.
+
+
+Navigating
+==========
+
Entering a Directory
A single :kbd:`LMB` click on a directory enters it.
Parent Directory :kbd:`P`
@@ -271,14 +285,14 @@
File Drop
-^^^^^^^^^
+---------
You can also drag and drop a file or directory from your file manager into the Blender File Browser.
This will move it to the directory of the dropped file, and the file will be selected.
-Selection
----------
+Selecting
+=========
Select
Both :kbd:`LMB` and :kbd:`RMB` clicks work.
@@ -288,7 +302,6 @@
Dragging
Dragging with :kbd:`LMB` starts a :ref:`box selection <tool-select-box>`.
-
.. note::
You can always select several entries in the File Browser,
@@ -298,7 +311,7 @@
Arrow Keys
-^^^^^^^^^^
+----------
It is also possible to select/deselect files by "walking" through them using the arrow keys:
@@ -315,8 +328,8 @@
(and highlighting 'parent' ``..`` entry will bring you up one level).
-File Management
----------------
+Editing
+=======
Delete Files :kbd:`Delete`, :kbd:`X`
Delete the currently selected files or directories by moving them to the operating system's "trash".
@@ -325,22 +338,3 @@
Rename :kbd:`F2`
Change the name for the currently selected file or directory.
-
-
-.. _file_browser-previews:
-
-Previews
---------
-
-.. figure:: /images/editors_file-browser_previews.png
-
- The File Browser in *Thumbnail* mode.
-
-In its *Thumbnail* display mode, the File Browser supports many types of previews. These include:
-
-- Image and video formats
-- Fonts
-- Blend-files
-- Internal :doc:`Data-blocks </files/data_blocks>`
-
-See :doc:`Blend-files Previews </files/blend/previews>` for how to manage Blender data previews.
More information about the Bf-docboard-svn
mailing list