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

Added documentation for extra file columns #526

Merged
merged 17 commits into from
Oct 17, 2024
Merged
Show file tree
Hide file tree
Changes from 2 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
Binary file added en/.gitbook/assets/extrafile-column-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added en/.gitbook/assets/extrafile-column-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 12 additions & 0 deletions en/finding-sorting-and-cleaning-entries/filelinks.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,3 +86,15 @@ To access any of an entry's links, click on the icon with the right mouse button
## Setting up external file types

In general, there is no need to change the settings of external file types. So, this setting is for advanced users. See [Manage external file types](../setup/externalfiletypes.md).

## Adding additional columns to entry table for file types

You can add extra columns to the entry table for storing linked files of a specific type, e.g. a column specifically for Markdown files which you use to write comments about particular entries. This can help you organise your linked files.
Copy link
Member

Choose a reason for hiding this comment

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

Be clear. Split the first sentence. Start a new one at "e.g.,", but use instead: "For instance, one might store longer comments in an external Markdown file. One wants to show the precense of this Markdown file using an extra column".

With this text, you introduce the running example "Markdown" explicitely.


To add a specific column, navigate to **File > Preferences > Entry Table**. This will show the dialog box shown below. Tick the option for **Show Extra Columns**, and then either directly type in `extrafile:<fileType>` into the text box or enter the dropdown and find the option `<fileType> (Custom)`. Don't forget to click Save!
Copy link
Member

Choose a reason for hiding this comment

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

Please follow the one-sentence-per-line rule. This makes diffing easier.

This sentence is a bit unclear. Please tell the user that <filetype> can be "Markdown", "PNG Image", or other things. The text should be self contained. Remember visually impaired persons so that documents should be accessible. the included image alt text do not contain the list of shown types. Thus, a person with a screen reader has no chance to get the information.

Split up the sentence. Say that after the click, new entries appear as choice at the end of the combo box.

Please also add that one needs to click the plus button right of the field to add.

Moreover, Say that the arrow up and down buttons can be used to move the field more up.


![Showing the entry table preferences option box](../.gitbook/assets/extrafile-column-1.png)

Then you may find the column on your entry table like so! (You may have to scroll right to find the column where you have added it, and drag it across to the position you desire).

![Result after adding new file column](../.gitbook/assets/extrafile-column-2.png)
Loading