[documentation/digikam-doc/sphinx] /: cleanup
Gilles Caulier
null at kde.org
Tue Dec 20 07:14:50 GMT 2022
Git commit 05047a0d3fa9eb23568c51ed488a35db5841c75e by Gilles Caulier.
Committed on 20/12/2022 at 07:14.
Pushed by cgilles into branch 'sphinx'.
cleanup
D +0 -118 attic/digikam/using-camera-basis.docbook
D +0 -67 attic/digikam/using-camera-intro.docbook
D +0 -179 attic/digikam/using-camera-processing.docbook
D +0 -20 attic/digikam/using-camera.docbook
D +- -- digital_camera/images/camera_download.png
D +- -- digital_camera/images/camera_handheldgps.png
D +- -- digital_camera/images/camera_targetalbumdialog.png
https://invent.kde.org/documentation/digikam-doc/commit/05047a0d3fa9eb23568c51ed488a35db5841c75e
diff --git a/attic/digikam/using-camera-basis.docbook b/attic/digikam/using-camera-basis.docbook
deleted file mode 100644
index ca710a3..0000000
--- a/attic/digikam/using-camera-basis.docbook
+++ /dev/null
@@ -1,118 +0,0 @@
-<sect2 id="using-camera-basis">
-<title>Basic Import Interface Operations</title>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-maininterface.png" format="PNG" />
- </imageobject>
- </inlinemediaobject>
- </para>
-
- <sect3 id="using-camera-info">
- <title>Getting information about the photographs</title>
-
- <para>
- Before downloading photographs to your computer, you may wish to see the camera item information. Using the <guilabel>Properties</guilabel> and <guilabel>Metadata</guilabel> tabs on the Right Sidebar will launch camera and photograph properties and metadata information.
- </para>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-itemproperties.png" format="PNG" />
- </imageobject>
- </inlinemediaobject>
- </para>
-
- <para>The Item Properties Sidebar Tab</para>
-
- <para>
- The Properties tab displays file information recorded by the camera and a selection of photograph information to describe how the image has been taken. A flag indicates if the image has not yet been downloaded to the computer. Note that all this information may be unavailable with some digital cameras.
- </para>
-
- <para>
- The Metadata tab displays internal picture's metadata like EXIF, Makernotes, GPS, &etc; This information is the same as <link linkend="using-sidebar-metadata">Metadata</link> from the &digikam; Right Sidebar. Note that all these metadata can be unavailable with some digital cameras.
- </para>
-
- </sect3>
-
- <sect3 id="using-camera-geolocation">
- <title>Geolocation Tab</title>
-
- <para>
- The <guilabel>Geolocation</guilabel> tab will open a map that allows you to see and edit the GPS location of the selected photographs. For a detailed description see the <link linkend="using-sidebar-maps">Geolocation</link> section of the Right Sidebar chapter of this handbook.
- </para>
-
- </sect3>
-
- <sect3 id="using-camera-download">
- <title>Downloading photographs to your computer</title>
-
- <para>
- To download photographs from your camera to your computer click the <guilabel>Download</guilabel> button on the main toolbar and then click <guilabel>Download All</guilabel> (or use <menuchoice><guimenu>Item</guimenu><guimenuitem>Download All</guimenuitem></menuchoice> from the main menu). This will download all of the photographs on the camera with the settings you used with your last download (Settings tab). The download process will not remove the photographs from the camera. It is always advisable to check that the photographs have downloaded safely into the Album you were expecting before deleting them from the camera.
- </para>
-
- <para>
- If you do not want to download all of the photographs you can select just those that you need using the standard selection methods. Once you have the photographs selected, click <guilabel>Download</guilabel> and then <guilabel>Download Selected</guilabel>. The <guilabel>Download Selected</guilabel> button will be grayed out until you have selected some photographs.
- </para>
-
- <para>
- Another option is <guilabel>Download new</guilabel>. New images are marked with a star in the upper right corner of the image icon. Once images are downloaded a "downloaded already" entry will be made in the &digikam; database and they are marked with a checker. Obviously, if you choose this handy option, it will download the new images only.
- </para>
-
- </sect3>
-
- <sect3 id="using-camera-upload">
- <title>Uploading Photographs to your camera</title>
-
- <para>
- To upload photographs from your computer to your camera click
- <menuchoice>
- <shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></shortcut>
- <guimenu>Item</guimenu><guimenuitem>Upload...</guimenuitem>
- </menuchoice>
- in the Import Interface menu. A standard file selection dialog will appear to select the files from your computer for copying to your camera. You can select more than one file using the standard selection methods.
- </para>
-
- <para>
- When images selection is done, &digikam; will ask you to where you want to upload the files on your camera. A camera folder selection dialog will appear. Just select one folder and press OK to start uploading. No images will be removed from your computer.
- </para>
-
- <example>
-
- <title>The Camera Folder Selection Dialog</title>
- <screenshot>
- <screeninfo>The Camera Folder Selection Dialog</screeninfo>
- <mediaobject><imageobject>
- <imagedata fileref="&path;using-camera-folderselectiondialog.png" format="PNG" />
- </imageobject></mediaobject>
- </screenshot>
-
- </example>
-
- <note><para>
- Uploading feature is not supported by all camera drivers.
- </para></note>
-
- </sect3>
-
- <sect3 id="using-camera-delete">
- <title>Deleting photographs from the camera</title>
-
- <para>
- Once you are happy with the downloaded photographs that you wanted, you are ready to delete photographs from the Camera. You can delete all of the photographs at once by clicking the <menuchoice><guimenu>Item</guimenu><guimenuitem>Delete All</guimenuitem></menuchoice> button. If you just want to delete a selection of the photographs, you have to select those that you want to delete and click <menuchoice><guimenu>Item</guimenu><guimenuitem>Delete Selected</guimenuitem></menuchoice>. You may also select <menuchoice><guimenu>Item</guimenu><guimenuitem>Delete New</guimenuitem></menuchoice>, for example if you feel that the images marked with the star are not worth downloading.
- </para>
-
- <caution><para>
- Please note that there is no way to restore a photo that you have deleted from the camera. The photographs are not moved to the internal Trash Can, they are removed completely. It is best to double check that you have successfully downloaded a photograph into a &digikam; album before you delete it from the camera. Anyway, if you plan to empty the camera card, you better do that from the camera menu because it is much quicker.
- </para></caution>
-
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-camera-intro.docbook b/attic/digikam/using-camera-intro.docbook
deleted file mode 100644
index 912047c..0000000
--- a/attic/digikam/using-camera-intro.docbook
+++ /dev/null
@@ -1,67 +0,0 @@
-<sect2 id="using-camera-intro">
- <title>Introduction to the Import Interface</title>
-
- <para>
- The Import Interface helps you to get photographs into a &digikam; Album, whether it is directly from your camera, from a USB mass storage device, via a card reader or from a local or remote folder. You can access the Import Interface by
- <variablelist>
- <varlistentry>
- <term><menuchoice>
- <guimenu>Import</guimenu><guimenuitem>Cameras</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Select one of the cameras from the submenu or choose <guilabel>Add Camera Manually...</guilabel>.
- </action></para>
- <para>
- The latter will open the dialog described in the <link linkend="using-setup-camera">Camera Settings</link> section of this handbook. If you want to have more information about how &digikam; supports digital cameras, please a take a look at <link linkend="intro-camerasupport">this section</link>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><menuchoice>
- <guimenu>Import</guimenu><guimenuitem>USB Storage Devices</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Select one of the USB devices from the submenu.
- </action></para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><menuchoice>
- <guimenu>Import</guimenu><guimenuitem>Card Readers</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Select one of the card readers from the submenu.
- </action></para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><menuchoice>
- <shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>I</keycap></keycombo></shortcut>
- <guimenu>Import</guimenu><guimenuitem>Add Images...</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Select a source folder from the dialog that opens.
- </action></para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- </para>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-camera-processing.docbook b/attic/digikam/using-camera-processing.docbook
deleted file mode 100644
index 4ddfd35..0000000
--- a/attic/digikam/using-camera-processing.docbook
+++ /dev/null
@@ -1,179 +0,0 @@
-<sect2 id="using-camera-processing">
-<title>Advanced Import Interface Operations</title>
-
-<para>
- The <guilabel>Settings</guilabel> tab of the Right Sidebar in the Import Interface opens five sections with advanced options for the import processing.
-</para>
-
- <sect3 id="using-camera-rename">
- <title>File Renaming Options</title>
-
- <para>
- Cameras often do not use very meaningful filenames for photographs. The filenames are usually reused once the photographs have been deleted from the camera. This can lead to filename clashes if you download photographs from many shootings into the same Album. It can also be useful to include the date and time that an image was taken into the filename.
- </para>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-setting1.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- </para>
-
- <para>
- If you select <guilabel>Camera filenames</guilabel> the image filenames will not be altered. But you have the option to change their case to upper or lower case with the <quote>Change case to:</quote> drop down field. If you select <guilabel>Customize</guilabel> you will be able to put together a renaming pattern from the Options drop down menu which contains original file name, file extension, owner and group, directory, a dialog for defining a sequence number and a dialog for adding date and time information, either fixed or based on the time information written by the camera into the image file.
- </para>
-
- <para>
- In the sequence number dialog you will find two options: <guilabel>Extension aware numbering</guilabel> and <guilabel>Folder aware numbering</guilabel>. If they are checked &digikam; will start a new sequence for every file extension and / or folder.
- </para>
-
- <para>
- The Date & Time dialog looks like this:
- </para>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-datetime.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- </para>
-
- <para>
- The calendar is active only if <quote>Fixed Date</quote> is selected from the <guilabel>Source:</guilabel> drop down field. This way you can add the same date and time information to the filenames of all imported images or videos. If <quote>Image</quote> is selected instead &digikam; will use the time information from the metadata of the image files. With the <guilabel>Format:</guilabel> drop down field you can choose from several standard date/time formats and a custom format. For the latter choose <guilabel>Custom</guilabel> in <guilabel>Format:</guilabel> drop-down list and fill in for example "dd.MM.yyyy hh:mm:ss". For more information, read <ulink url="http://doc.qt.io/qt-5/qdatetime.html#toString">QDateTime</ulink> class reference.
- </para>
-
- <para>
- In addition these options can be customized further with the help of a number of modifiers. A list of all options and modifiers together with a short explanations will open when clicking the info button.
- </para>
-
- <tip>
- <para>
- The sequence number may be needed if you have a camera with a very fast multi-shoot mode where it is possible to get two photographs with exactly the same data and time.
- </para>
- </tip>
-
- <para>
- The new filename that &digikam; will use for the photographs when they are downloaded is shown underneath the thumbnail in the image icon. The renaming settings will be remembered the next time you use the camera interface.
- </para>
-
-<caution><para>
- At the moment &digikam; cannot read metadata of RAW files during the import. You might want to import the files while preserving camera filenames first and then rename them after the import using the rename function (F2).
- </para></caution>
-
- </sect3>
-
- <sect3>
- <title>Auto-Creation of Albums</title>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-setting3.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- </para>
-
- <para>
- Check <guilabel>Extension-based sub-albums</guilabel> and &digikam; will create subalbums based on the file extensions of the imported images in the target album. &digikam; will open a dialog where you can choose the target album once you click one of the download options either from the toolbar or from the Item menu. If you want to create a new Album, into which you could download the photographs, click the <guilabel>New Album</guilabel> button. The new Album will be created as a sub-folder of the Album that is currently selected in the existing Album list. This means that if you do not want your new Album to be a sub-folder of an existing folder you must first select the collection where you want to create the new album. Collections are indicated by the
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-mainwindow-icon-collection.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- icon.
- </para>
-
- <para>
- If your camera provides information about the date of the photograph's taking or, if you import from a USB device or a folder, the images contain EXIF metadata with date/time information, &digikam; can use this to automatically create subalbums in the target album during import. Subalbums names will be based on the image dates. All images which have the same date will be downloaded into the same subalbum if you check <guilabel>Date-based sub-albums</guilabel>. Not all cameras include this information. See the <link linkend="using-sidebar-metadata">sidebar Metadata</link> section for more detail about information your camera may have embedded in your photographs.
- </para>
-
- </sect3>
-
-
- <sect3>
- <title>On the Fly Operations</title>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-setting2.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- </para>
-
- <para>
- This section of the Settings tab offers several options for JPEG images. The <guilabel>Template:</guilabel> drop-down field lets you choose one of your metadata templates you customized in <link linkend="using-setup-templates">Templates Settings</link>. You can access the Template Manager also with the edit button to the right of the drop-down field.
- </para>
-
- <para>
- <guilabel>Write the document name to EXIF</guilabel> and <guilabel>Fix internal date & time</guilabel> writes this information into the respective EXIF tags and XMP fields.
- </para>
-
- <para>
- If you check the next box &digikam; will perform the auto-rotate/flip action described in <link linkend="using-rotateimage">Lossless Image Rotation</link>.
- </para>
-
- <para>
- <guilabel>Convert to lossless file format</guilabel> allows you to convert the images to PNG, TIFF, PGF or JPEG2000 during import.
- </para>
-
- </sect3>
-
- <sect3>
- <title>DNG Convert Options</title>
-
- <para>
- <inlinemediaobject>
- <imageobject><imagedata fileref="&path;using-camera-setting4.png" format="PNG" /></imageobject>
- </inlinemediaobject>
- </para>
-
- <para>
- This section allows to enable the DNG conversion of RAW images by checking <guilabel>Convert RAW images to DNG container</guilabel> and to select options for that conversion. To learn more about Digital Negative (DNG) use the link <quote>DNG container</quote>.
- <variablelist>
- <varlistentry>
- <term><menuchoice>
- <guimenuitem>Embed original file</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Embeds the original RAW file into the DNG container.
- </action></para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><menuchoice>
- <guimenuitem>Lossless Compression</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Enables lossless compression. The difference between lossy and lossless compression is said to be practically indistinguishable with DNG.
- </action></para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><menuchoice>
- <guimenuitem>JPEG preview</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>
- Choose whether you want a medium or full size JPEG preview to be embedded into the DNG container or none at all.
- </action></para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
-
- </sect3>
-
- <sect3>
- <title>Scripting</title>
-
- <para>
- This last section of the Settings tab offers to run scripts to manipulate the images during import. You can type the filename of the script into the input field or search for it using the <guilabel>Browse...</guilabel> button. Check out the info button for additional expressions to customize the command line!
- </para>
- </sect3>
-
-</sect2>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/attic/digikam/using-camera.docbook b/attic/digikam/using-camera.docbook
deleted file mode 100644
index 5fc5ee0..0000000
--- a/attic/digikam/using-camera.docbook
+++ /dev/null
@@ -1,20 +0,0 @@
-<sect1 id="using-camera"> <title>Using a Digital Camera With &digikam;</title>
- <anchor id="camerainterface.anchor"/>
-
- <para>
- To be able to use your digital camera with &digikam;, connect the camera to your computer, switch the camera to the image display mode and turn it on. See your camera's user manual if you need more information.
- </para>
-
- &doc-using-camera-intro;
- &doc-using-camera-basis;
- &doc-using-camera-processing;
-
-</sect1>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
diff --git a/digital_camera/images/camera_download.png b/digital_camera/images/camera_download.png
deleted file mode 100644
index 806d1da..0000000
Binary files a/digital_camera/images/camera_download.png and /dev/null differ
diff --git a/digital_camera/images/camera_handheldgps.png b/digital_camera/images/camera_handheldgps.png
deleted file mode 100644
index 43ba637..0000000
Binary files a/digital_camera/images/camera_handheldgps.png and /dev/null differ
diff --git a/digital_camera/images/camera_targetalbumdialog.png b/digital_camera/images/camera_targetalbumdialog.png
deleted file mode 100644
index 3ec76ef..0000000
Binary files a/digital_camera/images/camera_targetalbumdialog.png and /dev/null differ
More information about the kde-doc-english
mailing list