[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