Ruler/Markers rewrite, part 1 of N

[ardour-manual] / include / metadata.html

diff --git a/include/metadata.html b/include/metadata.html
index 1c7f9690d635f263f92fc0847ee5cdabeb9ded47..bf746a08eced910e93ea57333c109d0ce5677a0e 100644 (file)
--- a/include/metadata.html
+++ b/include/metadata.html
@@ -1,10 +1,37 @@
-  
+
+<h2>Session Metadata</h2>
+
+<figure class="right">
+  <img src="/images/edit-session-metadata.png" alt="The session metadata editor">
+  <figcaption>
+               The session metadata editor
+  </figcaption>
+</figure>
+
+<p>
+  Sessions can have various items of metadata attached to them, and saved in the
+  session file. These metadata are filled by the user via
+  <kbd class ="menu">Session &gt; Metadata &gt; Edit Metadata&hellip;</kbd>.
+</p>
 <p>
-Sessions can have various items of metadata attached to them, via
-<kbd class ="menu">Session &gt; Metadata &gt; Edit Metadata...</kbd> and 
-<kbd class ="menu">Session &gt; Metadata &gt; Import Metadata...</kbd>.
+       These metadata will be exported as tags in the audio and video files that
+       support it, as long as the right option is chosen at the
+       <a href="@@export-dialog">export</a> stage. All the video format can retain a
+       subset of the metadata if the <kbd class="option">Include Session Metadata</kbd>
+       is checked in the <a href="@@workflow-amp-operations#export">export video</a>
+       window, while only the Ogg-Vorbis (tagged) and FLAC (tagged)
+       audio format will be exported with the metadata (as Vorbis comment).
 </p>
+<p>
+       Ardour can also reuse the metadata from another session file in the current
+       session, with <kbd class ="menu">Session &gt; Metadata &gt; Import Metadata&hellip;</kbd>.
+       This menu brings up a file selector, asking for the source ardour session file
+       to extract the data from. This can be handy when reusing a lot of information
+       (Author, Artist Name, etc&hellip;) or working on multiple tracks of the same
+       media.
+</p>
+
+
+
 
-<h2>Edit Session Metadata Dialog</h2>
-<img src="/images/edit-session-metadata.png" />