Issue 104691 - Alphabetical Indexes cross-reference
Summary: Alphabetical Indexes cross-reference
Status: CONFIRMED
Alias: None
Product: Writer
Classification: Application
Component: editing (show other issues)
Version: OOo 3.0
Hardware: All All
: P3 Trivial with 45 votes (vote)
Target Milestone: ---
Assignee: AOO issues mailing list
QA Contact:
URL:
Keywords:
: 114869 (view as issue list)
Depends on:
Blocks:
 
Reported: 2009-09-01 17:41 UTC by astrolabio
Modified: 2014-04-02 13:15 UTC (History)
4 users (show)

See Also:
Issue Type: ENHANCEMENT
Latest Confirmation in: ---
Developer Difficulty: ---


Attachments
PDF file (272.03 KB, text/plain)
2010-06-19 16:21 UTC, carlpaulooo
no flags Details
Test case (52.50 KB, application/msword)
2010-06-26 21:29 UTC, oooalpha
no flags Details
Is only a draft (68.63 KB, image/png)
2010-08-05 22:40 UTC, nicobo
no flags Details

Note You need to log in before you can comment on or make changes to this issue.
Description astrolabio 2009-09-01 17:41:24 UTC
Alphabetical Indexes cross-reference

Hi, sorry for my English.

You can not create cross-reference in the Insert Index dialog box.

http://wiki.services.openoffice.org/wiki/Documentation/OOoAuthors_User_Manual/Wr
iter_Guide/Creating_an_alphabetic_index#Adding_index_entries

cross-reference examples

Beijing......see China
Belgium...........p 8-10
China.............p 27-29
Greenland.........p 12-14
Madrid.......see Spain
Spain.............p 18-31

MsWord can do
http://word.tips.net/FigFiles/T1900F1.html

Indexing unresolved issues:
http://www.bayside-indexing.com/embed.htm
Comment 1 michael.ruess 2009-09-02 14:08:13 UTC
Reassigned to requirements.
Comment 2 astrolabio 2009-09-08 12:22:15 UTC
This issue is similar:
http://www.openoffice.org/issues/show_bug.cgi?id=24250
Comment 3 nebbiolo 2010-02-13 14:38:53 UTC
Very important feature on the build of a good index
Comment 4 userwriter 2010-02-25 15:02:56 UTC
Please implemented this feature!
OOo writer indexing tools needs improvement.
Alphabetical index is CRUCIAL for academic use and publishing.
Creating a basic working index requires a small, but essential set of functions.
Missing one or more of these features severely affects the ability to create an
effective index.

I recommend reading this papaer (in particular pages 6 and 7)
http://www.allegrotechindexing.com/indexingtools.pdf

Issues very important 

Allowing more than one Alphabetical Index
http://qa.openoffice.org/issues/show_bug.cgi?id=6401

Footnotes are not included in Alphabetical Index
http://qa.openoffice.org/issues/show_bug.cgi?id=32392

Alphabetical Indexes cross-reference
http://qa.openoffice.org/issues/show_bug.cgi?id=104691

Index markers do not support cross references or bookmarks
http://qa.openoffice.org/issues/show_bug.cgi?id=24250

Alphabetical index: allow marking pages as entry range even if the keyword
doesn't appear on every pages
http://qa.openoffice.org/issues/show_bug.cgi?id=94565

A very interesting idea
Navigator should also list all Index Entries
http://qa.openoffice.org/issues/show_bug.cgi?id=61643
Comment 5 fh1970 2010-06-02 00:45:05 UTC
SEE / SEE ALSO

See: Refers you from an unused term to a used term. For example, "ornithology, 
see birds" means that anything about birds in this document is listed under 
birds in the index, not under the more scientific term of ornithology. In the 
index, only birds has a page number reference.
See also: Refers you to other used terms related to this one. These terms may be 
"siblings" or "children" of the parent term. For example, you may see "birds, 
see also reptiles". Both terms are at an equal level, so are "siblings. However, 
"birds, see also eagles, flamingos, parakeets" refer to terms that are narrower 
than the parent term birds, so are "child" terms. All terms are listed in the 
index with their respective page number references. 

For those that want something automatic the Index generation must provide:

see:
If there is only one index mark (inserted for a cross reference).

see also:
If there are more than one index mark (inserted for a cross reference).


OpenOffice...........................7,8,12,21
Word Processor......................See Writer
Writer.............1,8,11; See also OpenOffice

For greater compatibility with MsWord should include the possibility of cross-
references user-defined.

The XE Field: {XE "main heading:subheading one" \t "See cross-reference"}
Comment 6 userwriter 2010-06-03 16:27:44 UTC
The simplest solution is to let the user to define cross-reference (as in 
MSWord).

Note that both “See also” and “See” cross-references are completely internal to 
the index, and as such do not have page numbers. And because they do not have 
page numbers, the index markers can be placed anywhere in the text.

Theoretically it would be enough add a sixth page in the "Insert Index/Table 
dialog-box" (Insert > Indexes and Tables > Indexes and Tables) where you can 
insert and customize the appearance of entries with cross references.

The index markers of entries with cross references could be included by 
convention at the end of the document or chapter.
Comment 7 carlpaulooo 2010-06-19 16:21:43 UTC
Created attachment 70099 [details]
PDF file
Comment 8 carlpaulooo 2010-06-19 16:24:04 UTC
Are not a developer ...
I just thought how to change the UI to allow the use of cross-references in
alphabetical indexes.
The restyling should be minimal!

Attachment
http://www.openoffice.org/nonav/issues/showattachment.cgi/70099/104691.pdf

I apologize for my English
best regards

Carl
Comment 9 helmut_lothar 2010-06-19 23:51:32 UTC
Anyone who has seen an index, knows that this feature is necessary!
Helmut
Comment 10 oooalpha 2010-06-26 21:29:08 UTC
Created attachment 70239 [details]
Test case
Comment 11 oooalpha 2010-06-26 21:32:24 UTC
Is very urgent solve this issue (IMHO)!
MSWORD enables this feature and when you import a lot of information is lost!
The index entries are marked as cross references lose their reference and are
transformed into index entries, even if there not are in the document.

Code field (MsWord) of the index entry and a the cross-reference:

[OpenOffice.org]{XE "OpenOffice.org"}{XE "Office Automation" \t "See
OpenOffice.org"}

[OpenOffice.org]     -----> the text is marked in the document
{XE "OpenOffice.org"}   --> is the normal index entry
{XE "Office Automation"  -> is the index entry (not present in the text but only
in index)
\t "See OpenOffice.org"} -> is the cross-reference

should be
OpenOffice.org.......................page#
Office Automation.......see OpenOffice.org

instead it is imported so

Office Automation...........page#
OpenOffice.org..............page#

errors:
-remove the cross reference
-creates an index entry (Office Automation) that does not exist in the document.

I attach a sample document.
http://www.openoffice.org/nonav/issues/showattachment.cgi/70239/TEST.doc
Comment 12 00oit 2010-07-03 12:51:20 UTC
This issue is very important.
However, we must understand how to import and export msword cross-references.

msword code field
\ t "See OpenOffice.org"
"See" is in italics

The Writer fields not allow for direct formatting ( Issue 106199 ).
Comment 13 vovorban 2010-07-27 01:05:11 UTC
to 00oit
You're right.
One solution might be to insert the Cross reference in the text as hidden text
(The hidden text accepts direct formatting).
See my commentary on the Issue 24250
However, it must first resolve the Issue 104107 for proper use of cross-references.

To achieve this in this order:

Cars, see also Motor vehicles
     custom, 568-571
     family, 257, 570

"Cars" is Entry of the Cross-reference and is the 1st key of "custom" and
"family" (Issue 104107).

Some rules:
http://www.wiley.com/legacy/authors/guidelines/stmguides/5content.htm#CROSS
Comment 14 nicobo 2010-08-05 22:40:04 UTC
Created attachment 70977 [details]
Is only a draft
Comment 15 nicobo 2010-08-05 22:41:06 UTC
I like the idea of drop-down list proposed by "carlpaulooo".
http://www.openoffice.org/nonav/issues/showattachment.cgi/70099/104691.pdf
Here is my proposal with some variations.
Bye
Nic
Comment 16 sandystw 2010-08-11 05:17:23 UTC
Hi, my job is to write technical manuals and to me this issue is essential!
Even in the context of academic institutions, Indexing tools are a must - have
for users - and I would very much enjoy being able to use OOo Writer for my
work-related purposes as well!

Best of luck
Jonathan
Comment 17 ojoha 2010-08-17 14:41:43 UTC
The Index Entry with cross-reference is used once in a document, because it has
no page numbers.
Some examples:
MsWord: { XE "OOo" \t "See OpenOffice.org" }
LaTeX: \index { OOo|see{OpenOffice.org }}
DocBook: <indexterm><primary>OOo</primary><see>OpenOffice.org</see></indexterm>

ODF 1.2 is supported for this feature?
<text:alphabetical-index-mark text:string-value="..." text:key1="..."
text:key2="..." text:main-entry="true or false"/>

It seems not, but I'm not a developer... Don't panic? ODF should be improved?
Kind regards
Comment 18 robonaut 2010-10-06 13:57:14 UTC
I'm sorry, I realize now that this issue is a duplicate of issue 114869

I copied from the issue 114869

---
I have a suggestion for an enhancement.
(I'm a bit surprised by the lack of this feature.)

PROBLEM:
A type of index entries that point to related entries, instead of a page number,
is a common option in alphabetical index, it is key structural component of an
effective index. However, this option is still missing.
Please fill this gap.

MOTIVATIONS:
* It is common practice across printed material! 
http://www.theindexer.org/files/17-3/17-3_178.pdf
* ISO 999: 1996 (para.4) goes into detail. Users seeking information under terms
not chosen as headings should be directed to the chosen heading by see
references. Relationships between concepts should be indicated by the
heading/sub-heading (index keys) status and by see also references.
* Interoperability with Microsoft Word.
* Potential users:
- Education/Academic 
- Technical writer
- Lawyers
- Publishing
* Aside from that, it is very useful for the reader.

SUGGESTIONS:
Should be at least two types of cross references:

1."See/see also" forms, where the term referred to is a specific entry elsewhere
in the index.  Adobe InDesign automatically determines whether to use the
"See..." form (if there are no other entries) or the "See also" form (if there
are). 
http://help.adobe.com/en_US/InDesign/6.0/WSA556ED6A-9A1A-4ed3-8CC0-5F7D69C760DCa.html
I wish I had  something similar.

2."Custom" form, where you can type any kind of cross-reference you prefer, such
as "See also under", "see above" or "also look up".
Microsoft Word provides only this type.
http://office.microsoft.com/en-us/word-help/create-an-index-HP001226499.aspx#BM1
---
OpenOffice.org is a great software,
however, I had more of a problem with alphabetical indexes.
I tried to gather some information (Issue Tracker and Web) about these problems. 
http://www.openoffice.org/nonav/issues/showattachment.cgi/71959/Alphabetical_Index.pdf
Hope this helps someone.
Thanks for your attention (I hope my English was limpid).

Klaus

Comment 19 Edwin Sharp 2014-04-02 13:15:17 UTC
*** Issue 114869 has been marked as a duplicate of this issue. ***