Bug Hunting Session
Bug 118455 - Definition List (or Definition Index or Glossary) at the end of the page - EDITING
Summary: Definition List (or Definition Index or Glossary) at the end of the page - ED...
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Writer (show other bugs)
Version:
(earliest affected)
6.0.1.1 release
Hardware: All All
: medium enhancement
Assignee: Not Assigned
URL:
Whiteboard:
Keywords: needsUXEval
Depends on:
Blocks: TableofContents-Indexes
  Show dependency treegraph
 
Reported: 2018-06-29 14:27 UTC by csongor
Modified: 2018-07-05 08:35 UTC (History)
3 users (show)

See Also:
Crash report or crash signature:


Attachments
This is what I would like to see (47.38 KB, image/png)
2018-06-29 14:27 UTC, csongor
Details

Note You need to log in before you can comment on or make changes to this bug.
Description csongor 2018-06-29 14:27:02 UTC
Description:
Similarly to the Alphabetical Index, I would like to build a definition list at the end of the document. For example, if I write a 100 page long book about how to use computers then I would specify the word "file" on the first page and would use it several times later on.

With the current version of LibreOffice Writer, I can build an Index at the end of the document that lists each important word and their locations of occurrences but not their definition. Mostly, the first occurrence in the document defines the term but not necessarily. Sometimes a term is defined after building up some basic knowledge. 

Depending on where it is defined, the reader has to jump at least twice to reach the definition of a term: 
- from the usage of the term to the end of the document where the index is
- from the index to the page of the firs occurrence
- and to other occurrences if the first place was not the definition. 

Instead of this Index, I would like to build a List of Definitions at the end of the document. See the attached sample.

The steps I would like to make:
- select a word (or some adjacent words as a complete expression) within the document that I want to give the definition for.
- click a new menu item: Insert -> Table of Contents and Index -> Definition List Entry 
- in a pop-up dialog, the selected text (one or more words, let's call it "term") would appear as the Term to Define
- I would be able to modify the term because the actual form in the text can differ from the one that I want to define. For example, if I select "algorithms" from the text then probably I still would like to define the singular form "algorithm". (In other languages larger differences can also occur.)
- When I press OK in the dialog then, similarly to how a Footnote is created, the cursor would jump to the end of the document, the term would appear as a read-only content and I would be able to enter the definition. 
- if I select a term that already has been defined then I shouldn't be able to create a new definition but the cursor should jump to the existing definition.


Some extra wishes:

It would be nice if I could specify the format of 
- the terms in the Definition List
- the definitions and
- if they are written in a same paragraph or in two separated ones.

If the term and its definition appear in the same paragraph then they should be formatted by two Character Styles (say Definition List Entry and Definition List Definition) 

However, if they are in two paragraphs (like the attached sample) then a Paragraph Style should define how each looks.


Notes: this feature could be used not just in scientific documents. I can imagine that a long fantasy story with hundreds of characters could also benefit it.

Actual Results:
I cannot do it. 

(Sorry, I have no idea what to write here in case of an enhancement when the functionality doesn't exist at all but the form needs this field to fill.)

Expected Results:
I would like to do it.

(Sorry, I have no idea what to write here in case of an enhancement when the functionality doesn't exist at all but the form needs this field to fill.)


Reproducible: Always


User Profile Reset: No



Additional Info:
Comment 1 csongor 2018-06-29 14:27:50 UTC
Created attachment 143205 [details]
This is what I would like to see
Comment 2 Heiko Tietze 2018-07-02 08:57:33 UTC
The alphabetical list is exactly what you want. You define index entries that are listed (alphabetically) - IIRC there is a ticket on sort by occurrence. All following the standard guidelines of writing. 

What exactly is missing?
Comment 3 csongor 2018-07-04 13:56:06 UTC
If you ment "alphabetical index" (not alphabetical _list_) then it is not what I wanted. With the index I can collect the words at the end of the document but I cannot add their definitions to that place. The index just contains a reference to the single page or multitude of pages where the given word occurs.

If you check my attachment then you can see that I would like to add to the list of definitions not just the terms but their brief definition too. It can be a simplified definition in a scientific book, a simple reminder in a novel, a synonym in a document that uses foreign words, and so on.
Comment 4 Dieter Praas 2018-07-04 14:32:22 UTC
Heiko, I tried to produce a glossary (I think this is what csongor proposes) with alphabetical list, but I wasn't really successful. So I couldn't find a workaround and I support the proposal for a glossary.
Comment 5 csongor 2018-07-04 14:50:25 UTC
(In reply to Dieter Praas from comment #4)
> Heiko, I tried to produce a glossary (I think this is what csongor proposes)
> with alphabetical list, but I wasn't really successful. So I couldn't find a
> workaround and I support the proposal for a glossary.

Thanks, @Dieter, Glossary is a much better name for it. I added it to the summary of the bug so that it can be found more easily.
Comment 6 Heiko Tietze 2018-07-05 08:35:50 UTC
(In reply to Dieter Praas from comment #4)
> Heiko, I tried to produce a glossary... but I wasn't really successful

It works well when you know how to do (Insert > ToC > Index Entry -> "insert" as many selection you like/need;  Insert > ToC > ToC -> Alphabetical Index). The help should tell you everything, including how to access a file with words to index.

(In reply to csongor from comment #3)
> ...With the index I can collect the words at the end of the
> document but I cannot add their definitions to that place.

Do you have an idea, Regina?