add quick reference for actions

content/howto/_index.md

@@ -0,0 +1,7 @@
+---
+title: How do I ...?
+id: howto
+weight: 75
+draft: false
+author: "people"
+---

content/howto/add-text.md

@@ -0,0 +1,17 @@
+---
+title: add text to an image
+id: add-text
+weight: 80
+draft: false
+author: "people"
+---
+
+Use the [_watermark_](../module-reference/processing-modules/watermark.md)
+module with one of the text markers, i.e. "simple-text",
+"simple-text-shadow", or "fixed-size-text".
+
+You can add multi-line text with a single instance of the module by
+inserting "$(NL)" where the text should wrap to the next line.  Other
+[variables](../special-topics/variables.md) can also be inserted and
+will be replaced by their current values whenever the image is
+processed.

content/howto/batch-edit.md

@@ -0,0 +1,16 @@
+---
+title: batch edit photos
+id: batch-edit
+weight: 60
+draft: false
+author: "people"
+---
+
+To apply the same edit to multiple photos, you can
+
+- use a [style](../module-reference/utility-modules/lighttable/styles.md)
+
+- edit one photo and then [copy and paste](../module-reference/utility-modules/lighttable/history-stack.md)
+  the edits onto others
+
+See also the [tutorial](../guides-tutorials/batch-editing.md).

content/howto/clarity.md

@@ -0,0 +1,17 @@
+---
+title: add clarity
+id: batch-edit
+weight: 10
+draft: false
+author: "people"
+---
+
+What other programs call clarity is an adjustment of local contrast.
+You can do this in darktable with the
+[_local contrast_](../module-reference/processing-modules/local-contrast.md)
+module (on the [_Quick Access Panel_](../darkroom/organization/quick-access-panel.md)
+by default) or by starting with the "clarity" preset in the
+[_contrast equalizer_](../module-reference/processing-modules/contrast-equalizer.md)
+module (quite strong) or one of the "local contrast" presets in the
+[_diffuse and sharpen_](../module-reference/processing-modules/diffuse.md)
+module (generally very subtle).

content/howto/combine-images.md

@@ -0,0 +1,27 @@
+---
+title: combine multiple images
+id: combine-images.md
+weight: 30
+draft: false
+author: "people"
+---
+
+To combine multiple images, such as creating a mosaic or inserting
+additional content into an image (such as [replacing the
+sky](sky-replacement.md):
+
+- ensure that all images you want to combine have been
+  [imported](../module-reference/utility-modules/lighttable/import.md)
+  into your library
+
+- use [_canvas enlargement_](../module-reference/processing-modules/enlarge-canvas.md)
+  on one image (the "base" image) to add more space for the other images, if needed
+
+- use the
+  [_composite_](../module-reference/processing-modules/composite.md)
+  module and drag the second image from the filmstrip into the module.
+  Adjust the position, size, and rotation as desired.  Use a mask to
+  include only part of the overlaid image.
+
+- if you want to combine more than two images, create additional
+  instances of the _composite_ module, one per image

content/howto/contrast-bright-sat.md

@@ -0,0 +1,37 @@
+---
+title: adjust contrast/brightness/saturation
+id: hsl
+weight: 15
+draft: false
+author: "people"
+---
+
+To adjust contrast, you can use
+
+- the contrast slider in either [_filmic rgb_](../module-reference/processing-modules/filmic-rgb.md)
+  (on the _look_ tab) or [_sigmoid_](../module-reference/processing-modules/sigmoid.md)
+
+- the contrast slider in [_color balance rgb_](../module-reference/processing-modules/color-balance-rgb.md),
+  adjusting the _contrast gray fulcrum_ slider on the _masks_ tab to control the center point of the contrast
+
+- the [_contrast equalizer_](../module-reference/processing-modules/contrast-equalizer.md)
+  module for more localized contrast
+
+- the [_local contrast_](../module-reference/processing-modules/local-contrast.md)
+  module for very localized contrast enhancement, also known as
+  "clarity".
+
+To adjust brightness, you can use
+
+- the [_exposure_](../module-reference/processing-modules/exposure.md) module for linear adjustment
+
+- the _brilliance grading_ sliders in
+  [_color balance rgb_](../module-reference/processing-modules/color-balance-rgb.md)
+  for perceptual brightness adjustments
+
+To adjust saturation, you can use
+
+- the _global vibrance_, _chroma grading_, or _saturation grading_ sliders in
+  [_color balance rgb_](../module-reference/processing-modules/color-balance-rgb.md)
+
+- the [_velvia_](../module-reference/processing-module/velvia.md) module

content/howto/hsl.md

@@ -0,0 +1,17 @@
+---
+title: adjust hue/saturation/lightness (HSL)
+id: hsl
+weight: 10
+draft: false
+author: "people"
+---
+
+To adjust the hue, saturation, and/or lightness of pixels based on
+their original colors, use the
+[_color equalizer_](../module-reference/processing-modules/color-equalizer.md)
+module.
+
+To adjust the hue, saturation, and/or lightness of pixels based on
+their saturation or lightness, use the
+[_color zones_](../module-reference/processing-modules/color-zones.md)
+module.

content/howto/luminosity-masks.md

@@ -0,0 +1,19 @@
+---
+title: make a luminosity mask
+id: luminosity-masks
+weight: 110
+draft: false
+author: "people"
+---
+
+Since a luminosity masks adjusts the strength of an effect by the
+brightness of each pixel, you can accomplish this by creating a
+[_parametric mask_](../darkroom/masking-and-blending/masks/parametric.md)
+for the effect and adjusting the "g" (gray) or L/Jz channel controls.
+For a mask targeting highlights, move the upper left triangle all the
+way to the right; for a mask targeting shadows, move the upper right
+triangle all the way to the left.  A midtone mask can be created by
+moving both upper triangles to the middle; to match other software,
+you may need to reduce the _opacity_ slider to around 50%.  The gray
+channel will provide a scene-linear ramp, while the L and Jz channels
+produce a perceptually linear ramp.

content/howto/make-monochrome.md

@@ -0,0 +1,15 @@
+---
+title: make an image black&white/monochrome
+id: make-monochrome
+weight: 60
+draft: false
+author: "people"
+---
+
+See the tutorial [_developing monochrome images_](../guides-tutorial/monochrome.md).
+
+You can use the [_color calibration_](../module-reference/processing-modules/color-calibration.md),
+[_color balance rgb_](../module-reference/processing-modules/color-balance-rgb.md),
+or [_monochrome_](../module-reference/processing-modules/monochrome.md)
+modules to desaturate a color image to shades of gray.
+

content/howto/ooc-look.md

@@ -0,0 +1,32 @@
+---
+title: make image look like out-of-camera JPEG
+id: ooc-look
+weight: 150
+draft: false
+author: "people"
+---
+
+By default, darktable displays your raw images with minimal processing -
+just enough to get a displayable image (for unedited images, the
+lighttable thumbnail can be the embedded preview JPEG generated by the
+camera using the manufacturer's own algorithms).
+
+As of version 5.0, darktable ships with custom styles to make images
+from most supported camera models look more like the camera
+manufacturer's processing.  You can apply these manually or
+automatically on import.
+
+For automatic application, install and activate the
+`apply_camera_style` Lua script in the [script
+installer](../module-reference/utility-modules/lighttable/lua-scripts-installer.md).
+You can also use this script to apply the appropriate style to a
+selection of images which have already been imported.
+
+For manual application, open the
+[_styles_](../../module-reference/utility-modules/lighttable/styles.md)
+module and navigate to the `darktable camera styles` entry in the list
+of styles.  Expand this entry to show camera manufacturers, then
+expand the appropriate manufacturer to access its models.  Note that
+applying a different model's style to your camera's images is unlikely
+to make them look like JPEGs from the other model, but may still yield
+interesting results.

content/howto/radial-gradient.md

@@ -0,0 +1,17 @@
+---
+title: apply a radial gradient
+id: batch-edit
+weight: 70
+draft: false
+author: "people"
+---
+
+darktable does not have radial gradients, but you can get a very similar effect by
+[_masking_](../darkroom/masking-and-blending/masks/drawn.md)
+with a circle or ellipse which you adjust to a very small size with a
+very large feather to get a gradual drop-off in intensity in all
+directions from a central point.
+
+It is also possible to curve a gradient mask, but this is more
+appropriate for matching a curved line in the image than for emulating
+a point source for an effect.

content/howto/remove-default-modules.md

@@ -0,0 +1,23 @@
+---
+title: remove all the automatically-applied edits
+id: batch-edit
+weight: 5
+draft: false
+author: "people"
+---
+
+Most of the automatically-applied edits you see in the
+[_darkroom_](../darkroom.md) view when opening an image are required
+to display your raw file _at all_.  Other software applies equivalent
+edits, but doesn't tell you about it.
+
+Operations shown with a dot-inside-a-circle can not be turned off,
+because without them there is no image (a raw file is just a pile of
+sensor readings).
+
+Others which show with the usual power-button icon can be turned off,
+but are needed to have a _useful_ image display.  Automatic addition
+of the _color calibration_ and _filmic rgb_ or _sigmoid_ modules can
+be disabled by adjusting the auto-applied workflow defaults in the
+[_processing_](../preferences-settings/processing.md) tab of the
+_global preferences_ dialog.

content/howto/remove-object.md

@@ -0,0 +1,15 @@
+---
+title: remove an object from an image
+id: remove-object
+weight: 70
+draft: false
+author: "people"
+---
+
+darktable does not provide any AI-based object removal or inpainting
+methods, but you can replace an area in your image using either the
+[_retouch_](../module-reference/processing-modules/retouch.md)
+or [_composite_](../module-reference/processing-modules/composite.md)
+modules.  With _retouch_, you can replace the area with content from
+elsewhere in the same image using the "heal" or "clone" modes, while
+_composite_ lets you insert an arbitrary image from your library.

content/howto/shadows-highlights.md

@@ -0,0 +1,16 @@
+---
+title: adjust shadows/highlights
+id: hsl
+weight: 20
+draft: false
+author: "people"
+---
+
+To open shadows or improve details in highlights, use the
+[_tone equalizer_](../module-reference/processing-modules/tone-equalizer.md).
+
+On its _masking_ tab, click the two magic wands, and fine-tune the
+mask brightness with the _mask exposure compensation_ and _mask
+contrast compensation_ sliders.  Then move your mouse over areas of
+the image you want to adjust and scroll to brighten or darken areas of
+the image with that brightness.

content/howto/sky-replacement.md

@@ -0,0 +1,22 @@
+---
+title: replace the sky
+id: sky-replacement
+weight: 40
+draft: false
+author: "people"
+---
+
+To replace the sky in an image, you will first need another picture of
+just sky with the appearance you like.  Ensure that the image has been
+[imported](../module-reference/utility-modules/lighttable/import.md)
+into your library.
+
+On the image whose sky you want to replace, open the
+[_composite_](../module-reference/processing-modules/composite.md)
+module and drag your sky image from the filmstrip into the module.
+
+Turn on [parametric](../darkroom/masking-and-blending/masks/parametric.md)
+or [drawn and parametric](../darkroom/masking-and-blending/masks/drawn-and-parametric.md)
+masking, then use color and lightness to select the sky and optionally
+a drawn mask to exclude any areas which can't be excluded without
+losing a portion of the sky.

content/howto/smart-collections.md

@@ -0,0 +1,12 @@
+---
+title: create a "smart collection"
+id: luminosity-masks
+weight: 120
+draft: false
+author: "people"
+---
+
+Every [_collection_](../module-reference/utility-modules/shared/collections.md)
+in darktable is "smart", and will immediately update when an image's
+metadata changes such that it is newly included in or excluded from
+the collection's search criteria.

content/howto/undo.md

@@ -0,0 +1,21 @@
+---
+title: undo edits or other changes
+id: undo
+weight: 6
+applicable-version: 4.0
+draft: false
+author: "people"
+---
+
+Most actions done in [lightable view](../lighttable/undo-redo.md) can
+be reversed with the standard Ctrl-Z shortcut key and reapplied with
+Ctrl-Y.
+
+In darkroom view, you can either use
+[Ctrl-Z](../darkroom/pixelpipe/undo-redo.md) to undo actions one step
+at a time, or you can click on an item in the
+[_history stack_](../module-reference/utility-modules/darkroom/history-stack.md)
+module to reset the edit state to what it was when that item was added to
+the stack.  You can freely jump between different positions in the
+history as long as you do not change settings in any of the
+[processing modules](../module-reference/processing-modules/_index.md).

content/howto/unsqueeze-anamorphic.md

@@ -0,0 +1,14 @@
+---
+title: unsqueeze an anamorphic image
+id: unsqueeze-anamorphic
+weight: 100
+applicable-version: 4.8
+draft: false
+author: "people"
+---
+
+Images taken with an anamorphic lens will have a different pixel
+aspect ratio than the scene which was photographed.  To restore the
+correct appearance, use the
+_scale pixels_](../module-reference/processing-modules/scale-pixels.md)
+module.

content/howto/virtual-copy.md

@@ -0,0 +1,16 @@
+---
+title: make a virtual copy of an image
+id: virtual-copy
+weight: 50
+draft: false
+author: "people"
+---
+
+darktable calls multiple developments of a single image "duplicates".  You
+can create, remove, or name them using the
+_duplicate manager_](../module-reference/utility-modules/darkroom/duplicate-manager.md)
+in [_darkroom_](../darkroom/darkroom-view-layout.md) view, and you can
+create duplicates by selecting one or more images in the lighttable
+and clicking on the _duplicate_ button in the
+[_actions on selection_](../module-reference/utility-modules/lighttable/selected-image.md)
+module.