[Bf-docboard-svn] bf-manual: [9137] trunk/blender_docs/manual: VSE Documentation: Setup: Directory structure

[Aaron Carlisle]

Revision: 9137
          https://developer.blender.org/rBM9137
Author:   Blendify
Date:     2022-03-22 16:26:24 +0100 (Tue, 22 Mar 2022)
Log Message:
-----------
VSE Documentation: Setup: Directory structure

Authored by @Husch with edits by @blendify

Part of T87729

Modified Paths:
--------------
    trunk/blender_docs/manual/video_editing/setup/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/vse_setup_project_dir-structure-example.png
    trunk/blender_docs/manual/video_editing/setup/directory_structure.rst

Added: trunk/blender_docs/manual/images/vse_setup_project_dir-structure-example.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/vse_setup_project_dir-structure-example.png
===================================================================
--- trunk/blender_docs/manual/images/vse_setup_project_dir-structure-example.png	2022-03-22 15:08:22 UTC (rev 9136)
+++ trunk/blender_docs/manual/images/vse_setup_project_dir-structure-example.png	2022-03-22 15:26:24 UTC (rev 9137)

Property changes on: trunk/blender_docs/manual/images/vse_setup_project_dir-structure-example.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/video_editing/setup/directory_structure.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/setup/directory_structure.rst	                        (rev 0)
+++ trunk/blender_docs/manual/video_editing/setup/directory_structure.rst	2022-03-22 15:26:24 UTC (rev 9137)
@@ -0,0 +1,37 @@
+
+*******************
+Directory Structure
+*******************
+
+A video project is most likely a combination of several different assets.
+You can separate them into three broad categories.
+
+- Video files: video clips (or movies in Blender-talk), photos, graphic files (charts, logos, ...),
+  and Visual Effects (VFX) such as masks, lens flares, animation.
+- Audio files: recorded dialog, voice-over, music, and Sound Effects (SFX) such as environmental sounds, swooshes, ...
+- Project files: the blend files and backups, (partial) render results, documentation such as scripts and storyboards.
+
+Together they can form rapidly an intangible heap of files.
+It's good practice to collect all those assets in *one* project directory with appropriate subdirectories.
+Why? It will lower the probability that you accidentally delete a file
+(which will result in a 'file not found' error) or that you forget
+to include a necessary file when transferring the project ('file is missing' error).
+And most of all, an appropriate directory structure, will help you to keep a clear overview of your assets.
+
+.. seealso::
+
+    Blender can incorporate some files within the Blend file (see :doc:`Packed Data </files/blend/packed_data>`).
+    However, this doesn't work with video files, which can have very huge file sizes.
+    So, it's better to assure that your project directory contains all necessary files.
+
+It's also good practice to use some kind of naming convention and add metadata.
+Figure 1 shows a possible example, based on our categorization of the assets above.
+The directories are numbered so that they mimic a normal workflow.
+
+.. figure:: /images/vse_setup_project_dir-structure-example.png
+   :scale: 50 %
+   :alt: Organizing your project
+
+   Figure 1: Organizing your project.
+
+Blender haven't yet implemented the concept of Bins (virtual directories that only exist within the project). Nor does it have a full-blown asset manager for its video assets. For the moment, you're stuck with the `File Browser <https://docs.blender.org/manual/en/dev/editors/file_browser.html>`_.


Property changes on: trunk/blender_docs/manual/video_editing/setup/directory_structure.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/video_editing/setup/index.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/setup/index.rst	2022-03-22 15:08:22 UTC (rev 9136)
+++ trunk/blender_docs/manual/video_editing/setup/index.rst	2022-03-22 15:26:24 UTC (rev 9137)
@@ -7,3 +7,4 @@
    :maxdepth: 2
 
    introduction.rst
+   directory_structure.rst