Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update content/print/overview.md #662

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 3 additions & 5 deletions content/print/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,8 @@ draft: false
author: "people"
---

This view allows you to print your images. Because printing is not easy, there are many technical aspects to be taken into account.
This view allows you to select and print your images.

After selecting an image in the [lighttable view](../lighttable/_index.md) you can enter the [print settings](../module-reference/utility-modules/print/print-settings.md) module to adjust printer settings and initiate printing.
The first step is to select an image in the [lighttable view](../lighttable/_index.md), then switch to the print view. The selected image will be displayed in the centre panel and the [print settings](../module-reference/utility-modules/print/print-settings.md) module will now allow you to adjust printer settings and initiate printing.

This module supports the printer's ICC profile, which is somewhat mandatory if you want to obtain a high quality print close to the image displayed on the screen.

It is important to note that ICC profiles provided by the paper and/or printer manufacturers cannot be used on GNU/Linux as they are printer-driver dependent. The darktable print module uses CUPS and there are no ready-to-use ICC profiles available for this driver.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a reason for removing this "important" paragraph?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well the text is pretty opaque, and its hard to see what relevance it has to the user. It seems to be describing an aspect of the workflow of the module, and is not something the user can affect.

Maybe its of use to whoever is maintaning the module, but even then it needs a rewrite.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks to be useful information for users and I'm pretty sure I understand what it's saying (you cannot use manufacturer-produced ICC profiles because they're designed for the manufacturer-produced printer drivers -- i.e. for Window$ and/or Mac) . If you don't understand it, that's not necessarily a reason to remove it.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Chris, You and I may understand it, but we are not the target audience for the user manual.

Users come to the print overview because they want to understand dt printing better, or have a particular problem. Therefore the text should be accessible to an intelligent non-specialist.

If the user doesn't already know what an ICC profile is, then the text in question is unlikely to be relevant to their problems, and the warning is superfluous.

If they do know a bit about ICC profiles then, in my opinion, the text is imprecise and in some ways self contradicting.

"this module supports the printer's ICC profile . . ." probably means "this module *uses . . . " and the rest of the sentence just states the obvious.

The sentence about not using the printer ICC profile on Linux is hard to understand. I only run Linux , so where does the profile fit in to my print workflow? Also, dt does not provide any means to directly access the printer profile, so what is the text warning against? If the user really wants to try to reuse the printer ICC profile, they must already have some knowledge and expertise outside of dt in order to get hold of it. In which case they wouldnt be asking the dt manual for help.

So anyway, my feeling is that the text would be much clearer and potentially more useful if it included a description of the dt workflow for printing - explaining why multiple ICC profiles are needed and how dt interacts with printer drivers. In this case, I don't think the text belongs in a section called "overview" but potentially in a new section called Print Workflow, that can include more technical information.

Overall I am just providing feedback and suggestions, you are the gatekeeper - your call!

The [filmstrip](../module-reference/utility-modules/shared/filmstrip.md) at the bottom of the screen is active and you can select more images into the centre panel ready for printing.