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

Overhaul Entry Editor Preview (#7093) #329

Merged
merged 1 commit into from
Nov 22, 2020
Merged
Show file tree
Hide file tree
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
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/entryeditor-preview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 23 additions & 2 deletions en/setup/preview.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,25 @@
# Entry preview setup
# Entry Preview Setup

The entry preview is created using the same mechanism as used by the [Custom export filter](../collaborative-work/export/customexports.md) facility. When previewed, an entry is processed using one of the two alternative layouts \(you can switch between the two layouts by pressing F9\) to produce HTML code which is displayed by the preview panel. To modify the appearance and contents of the preview you need to edit the preview layouts using the syntax described in the help file on [Custom export filters](../collaborative-work/export/customexports.md).
## Location

The __Entry Preview__ is located inside the __Entry Editor__ (except when navigated to the `File annotations` or `{} biblatex source` tab):

![Entry Preview](../.gitbook/assets/entryeditor-preview.png)

You can display the entry preview as a separate tab (see screenshot above) by checking the box `Show preview as a tab in entry editor` in the entry preview settings `Options > Preferences > Entry preview > Current Preview` (see screenshot below).

## Layouts/Styles

The entry preview displays either the __Customized Preview Style__ or a certain __Citation Style__. You can select the styles that should be available for display in `Options > Preferences > Entry preview > Current Preview`. In `Available` you find all styles selectable for display, in `Selected` all styles already selected for display:

![Entry Preview Settings](../.gitbook/assets/entryeditor-preview-settings.png)

You can switch between all selected styles (customized preview and citation styles) in the entry preview in the main window by pressing `F9`.

## Display Mechanism

The layout is automatically created using the same mechanism as used by the [Custom export filter](../collaborative-work/export/customexports.md) facility. When previewed, an entry is processed using one of the selected layouts/styles to produce HTML code which is displayed by the preview panel.

## Modification of the Customized Preview Style

To customize the appearance and contents of the customize entry preview you need to edit/modify the customized preview style in the entry preview settings (see screenshot above) using the custom export filter syntax described in the [Documentation](../collaborative-work/export/customexports.md).