JabRef 6.0-beta.1 · org.jabref.logic.openoffice.frontend.OOFrontend

Modifier and Type	Field and Description
public final Backend52	backend
public final CitationGroups	citationGroups

Access	Constructor and Description
public	OOFrontend(com.sun.star.text.XTextDocument doc)

Method Summary

Modifier and Type	Method and Description
public void	applyCitationEntries(com.sun.star.text.XTextDocument doc, List<CitationEntry> citationEntries)
public List<RangeForOverlapCheck<CitationGroupId>>	bibliographyRanges(com.sun.star.text.XTextDocument doc)
public OOVoidResult<JabRefException>	checkRangeOverlaps(com.sun.star.text.XTextDocument doc, List<RangeForOverlapCheck<CitationGroupId>> userRanges, boolean Report range pairs that only share a boundary. requireSeparation, int Limit number of overlaps reported (0 for no limit) reportAtMost)
public OOVoidResult<JabRefException>	checkRangeOverlapsWithCursor(com.sun.star.text.XTextDocument doc, List<RangeForOverlapCheck<CitationGroupId>> userRanges, boolean requireSeparation, OOStyle style) Check for any overlap between userRanges and protected ranges.
public void	cleanFillCursorForCitationGroup(com.sun.star.text.XTextDocument doc, CitationGroup group) Remove brackets added by getFillCursorForCitationGroup.
public static OOResult<OOFrontend, JabRefException>	create(com.sun.star.text.XTextDocument doc)
public CitationGroup	createCitationGroup(com.sun.star.text.XTextDocument doc, com.sun.star.uno.XComponentContext context, List<String> In storage order citationKeys, @NonNull List<Optional<OOText>> In storage order pageInfos, CitationType citationType, com.sun.star.text.XTextCursor Collapsed to its end. position, boolean If true, we insert a space before the mark. insertSpaceBefore, boolean If true, we insert a space after the mark, that carries on format of characters from the original position. insertSpaceAfter) Create a citation group for the given citation keys, at the end of position.
private List<RangeSortable<CitationGroup>>	createVisualSortInput(com.sun.star.text.XTextDocument doc, boolean If true, replace ranges in footnotes with the range of the corresponding footnote mark. This is used for numbering the citations. mapFootnotesToFootnoteMarks) Creates a list of `RangeSortable<CitationGroup>` values for our `CitationGroup` values.
public List<RangeForOverlapCheck<CitationGroupId>>	footnoteMarkRanges(List<RangeForOverlapCheck<CitationGroupId>> citationRanges) Returns: A range for each footnote mark where the footnote contains at least one citation group.
public List<CitationEntry>	Returns: A list with entries corresponding to citations in the text, in arbitrary order (same order as from getJabRefReferenceMarkNames). Note visual or alphabetic order could be more manageable for the user. We could provide these here, but switching between them needs change on GUI (adding a toggle or selector). Note CitationEntry implements Comparable, where compareTo() and equals() are based on refMarkName. The order used in the "Manage citations" dialog does not seem to use that. The 1st is labeled "Citation" (show citation in bold, and some context around it). The columns can be sorted by clicking on the column title. For the "Citation" column, the sorting is based on the content, (the context before the citation), not on the citation itself. In the "Extra information ..." column some visual indication of the editable part could be helpful. Wish: selecting an entry (or a button in the line) in the GUI could move the cursor in the document to the entry. getCitationEntries(com.sun.star.text.XTextDocument doc) GUI: Get a list of CitationEntry objects corresponding to citations in the document.
public List<CitationGroup>	getCitationGroupsSortedWithinPartitions(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks) Return citation groups in visual order within (but not across) XText partitions.
public List<RangeForOverlapCheck<CitationGroupId>>	getCitationRanges(com.sun.star.text.XTextDocument doc, OOStyle style)
public com.sun.star.text.XTextCursor	getFillCursorForCitationGroup(com.sun.star.text.XTextDocument doc, CitationGroup group)
public List<RangeForOverlapCheck<CitationGroupId>>	getJStyleCitationRanges(com.sun.star.text.XTextDocument doc) Returns: A RangeForOverlapCheck for each citation group.
public Optional<com.sun.star.text.XTextRange>	Returns: Optional.empty() if the reference mark is missing. getMarkRange(com.sun.star.text.XTextDocument doc, CitationGroup group) ranges controlled by citation groups should not overlap with each other.
private List<RangeForOverlapCheck<CitationGroupId>>	getReferenceMarkCitationRanges(com.sun.star.text.XTextDocument doc) Returns: A RangeForOverlapCheck for each non-JStyle citation represented by a Writer reference mark.
private List<CitationGroup>	getVisuallySortedCitationGroups(com.sun.star.text.XTextDocument doc, boolean If true, sort reference marks in footnotes as if they appeared at the corresponding footnote mark. mapFootnotesToFootnoteMarks, FunctionalTextViewCursor fcursor) Returns: citation groups sorted by their visual positions.
public void	imposeGlobalOrder(com.sun.star.text.XTextDocument doc, FunctionalTextViewCursor fcursor)
pack-priv static String	rangeOverlapsToMessage(List<RangeOverlap<RangeForOverlapCheck<CitationGroupId>>> overlaps)
private static Map<CitationGroupId, CitationGroup>	readCitationGroupsFromDocument(Backend52 backend, com.sun.star.text.XTextDocument doc, List<String> citationGroupNames)
public void	removeCitationGroup(CitationGroup group, com.sun.star.text.XTextDocument doc) Remove `group` both from the document and notify `citationGroups`
public void	removeCitationGroups(List<CitationGroup> citationGroups, com.sun.star.text.XTextDocument doc)
public List<RangeForOverlapCheck<CitationGroupId>>	viewCursorRanges(com.sun.star.text.XTextDocument doc)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

backend	back to summary
public final Backend52 backend

citationGroups	back to summary
public final CitationGroups citationGroups

OOFrontend	back to summary
public OOFrontend(com.sun.star.text.XTextDocument doc) throws NoDocumentException, com.sun.star.lang.WrappedTargetException

Method Detail

applyCitationEntries	back to summary
public void applyCitationEntries(com.sun.star.text.XTextDocument doc, List<CitationEntry> citationEntries) throws com.sun.star.beans.PropertyVetoException, com.sun.star.beans.IllegalTypeException, IllegalArgumentException, com.sun.star.lang.WrappedTargetException

bibliographyRanges	back to summary
public List<RangeForOverlapCheck<CitationGroupId>> bibliographyRanges(com.sun.star.text.XTextDocument doc) throws NoDocumentException, com.sun.star.lang.WrappedTargetException

checkRangeOverlaps	back to summary
public OOVoidResult<JabRefException> checkRangeOverlaps(com.sun.star.text.XTextDocument doc, List<RangeForOverlapCheck<CitationGroupId>> userRanges, boolean requireSeparation, int reportAtMost) Parameters requireSeparation:boolean Report range pairs that only share a boundary. reportAtMost:int Limit number of overlaps reported (0 for no limit)

checkRangeOverlapsWithCursor	back to summary
public OOVoidResult<JabRefException> checkRangeOverlapsWithCursor(com.sun.star.text.XTextDocument doc, List<RangeForOverlapCheck<CitationGroupId>> userRanges, boolean requireSeparation, OOStyle style) Check for any overlap between userRanges and protected ranges. Assume userRanges is small (usually 1 elements for checking the cursor) Returns on first problem found.

checkRangeOverlapsWithCursor

back to summary

public OOVoidResult<JabRefException> checkRangeOverlapsWithCursor(com.sun.star.text.XTextDocument doc, List<RangeForOverlapCheck<CitationGroupId>> userRanges, boolean requireSeparation, OOStyle style)

Check for any overlap between userRanges and protected ranges.

Assume userRanges is small (usually 1 elements for checking the cursor)

Returns on first problem found.

cleanFillCursorForCitationGroup	back to summary
public void cleanFillCursorForCitationGroup(com.sun.star.text.XTextDocument doc, CitationGroup group) throws NoDocumentException, com.sun.star.lang.WrappedTargetException Remove brackets added by getFillCursorForCitationGroup.

create	back to summary
public static OOResult<OOFrontend, JabRefException> create(com.sun.star.text.XTextDocument doc)

createCitationGroup back to summary

createCitationGroup	back to summary
public CitationGroup createCitationGroup(com.sun.star.text.XTextDocument doc, com.sun.star.uno.XComponentContext context, List<String> citationKeys, @NonNull List<Optional<OOText>> pageInfos, CitationType citationType, com.sun.star.text.XTextCursor position, boolean insertSpaceBefore, boolean insertSpaceAfter) throws CreationException, NoDocumentException, com.sun.star.lang.WrappedTargetException, com.sun.star.beans.NotRemoveableException, com.sun.star.beans.PropertyVetoException, com.sun.star.beans.IllegalTypeException Create a citation group for the given citation keys, at the end of position. On return `position` is collapsed, and is after the inserted space, or at the end of the reference mark. Parameters citationKeys:List<String> In storage order pageInfos:@NonNull List<Optional<OOText>> In storage order position:com.sun.star.text.XTextCursor Collapsed to its end. insertSpaceBefore:boolean If true, we insert a space before the mark. insertSpaceAfter:boolean If true, we insert a space after the mark, that carries on format of characters from the original position.

public CitationGroup createCitationGroup(com.sun.star.text.XTextDocument doc, com.sun.star.uno.XComponentContext context, List<String> citationKeys, @NonNull List<Optional<OOText>> pageInfos, CitationType citationType, com.sun.star.text.XTextCursor position, boolean insertSpaceBefore, boolean insertSpaceAfter) throws CreationException, NoDocumentException, com.sun.star.lang.WrappedTargetException, com.sun.star.beans.NotRemoveableException, com.sun.star.beans.PropertyVetoException, com.sun.star.beans.IllegalTypeException

Create a citation group for the given citation keys, at the end of position.

On return position is collapsed, and is after the inserted space, or at the end of the reference mark.

Parameters

citationKeys:List<String>: In storage order
pageInfos:@NonNull List<Optional<OOText>>: In storage order
position:com.sun.star.text.XTextCursor: Collapsed to its end.
insertSpaceBefore:boolean: If true, we insert a space before the mark.
insertSpaceAfter:boolean: If true, we insert a space after the mark, that carries on format of characters from the original position.

createVisualSortInput back to summary

createVisualSortInput	back to summary
private List<RangeSortable<CitationGroup>> createVisualSortInput(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks) throws NoDocumentException, com.sun.star.lang.WrappedTargetException Creates a list of `RangeSortable<CitationGroup>` values for our `CitationGroup` values. Originally designed to be passed to `visualSort`. The elements of the returned list are actually of type `RangeSortEntry<CitationGroup>`. The result is sorted within `XTextRange.getText()` partitions of the citation groups according to their `XTextRange` (before mapping to footnote marks). In the result, RangeSortable.getIndexInPosition() contains unique indexes within the original partition (not after mapFootnotesToFootnoteMarks). Parameters mapFootnotesToFootnoteMarks:boolean If true, replace ranges in footnotes with the range of the corresponding footnote mark. This is used for numbering the citations.

private List<RangeSortable<CitationGroup>> createVisualSortInput(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks) throws NoDocumentException, com.sun.star.lang.WrappedTargetException

Creates a list of RangeSortable<CitationGroup> values for our CitationGroup values. Originally designed to be passed to visualSort.

The elements of the returned list are actually of type RangeSortEntry<CitationGroup>.

The result is sorted within XTextRange.getText() partitions of the citation groups according to their XTextRange (before mapping to footnote marks).

In the result, RangeSortable.getIndexInPosition() contains unique indexes within the original partition (not after mapFootnotesToFootnoteMarks).

Parameters

mapFootnotesToFootnoteMarks:boolean: If true, replace ranges in footnotes with the range of the corresponding footnote mark. This is used for numbering the citations.

footnoteMarkRanges	back to summary
public List<RangeForOverlapCheck<CitationGroupId>> footnoteMarkRanges(List<RangeForOverlapCheck<CitationGroupId>> citationRanges) Returns:List<RangeForOverlapCheck<CitationGroupId>> A range for each footnote mark where the footnote contains at least one citation group. Purpose: We do not want markers of footnotes containing reference marks to overlap with reference marks. Overwriting these footnote marks might kill our reference marks in the footnote. Note Here we directly communicate to the document, not through the backend. This is because mapping ranges to footnote marks does not depend on how do we mark or structure those ranges.

footnoteMarkRanges

back to summary

public List<RangeForOverlapCheck<CitationGroupId>> footnoteMarkRanges(List<RangeForOverlapCheck<CitationGroupId>> citationRanges)

Returns:List<RangeForOverlapCheck<CitationGroupId>>: A range for each footnote mark where the footnote contains at least one citation group. Purpose: We do not want markers of footnotes containing reference marks to overlap with reference marks. Overwriting these footnote marks might kill our reference marks in the footnote.
Note
Here we directly communicate to the document, not through the backend. This is because mapping ranges to footnote marks does not depend on how do we mark or structure those ranges.

getCitationEntries	back to summary
public List<CitationEntry> getCitationEntries(com.sun.star.text.XTextDocument doc) throws com.sun.star.lang.WrappedTargetException, NoDocumentException GUI: Get a list of CitationEntry objects corresponding to citations in the document. Called from: ManageCitationsDialogViewModel constructor. Returns:List<CitationEntry> A list with entries corresponding to citations in the text, in arbitrary order (same order as from getJabRefReferenceMarkNames). Note visual or alphabetic order could be more manageable for the user. We could provide these here, but switching between them needs change on GUI (adding a toggle or selector). Note CitationEntry implements Comparable, where compareTo() and equals() are based on refMarkName. The order used in the "Manage citations" dialog does not seem to use that. The 1st is labeled "Citation" (show citation in bold, and some context around it). The columns can be sorted by clicking on the column title. For the "Citation" column, the sorting is based on the content, (the context before the citation), not on the citation itself. In the "Extra information ..." column some visual indication of the editable part could be helpful. Wish: selecting an entry (or a button in the line) in the GUI could move the cursor in the document to the entry.

getCitationEntries

back to summary

public List<CitationEntry> getCitationEntries(com.sun.star.text.XTextDocument doc) throws com.sun.star.lang.WrappedTargetException, NoDocumentException

GUI: Get a list of CitationEntry objects corresponding to citations in the document.

Called from: ManageCitationsDialogViewModel constructor.

Returns:List<CitationEntry>

A list with entries corresponding to citations in the text, in arbitrary order (same order as from getJabRefReferenceMarkNames).

Note

visual or alphabetic order could be more manageable for the user. We could provide these here, but switching between them needs change on GUI (adding a toggle or selector).

Note

CitationEntry implements Comparable, where compareTo() and equals() are based on refMarkName. The order used in the "Manage citations" dialog does not seem to use that.

The 1st is labeled "Citation" (show citation in bold, and some context around it).

The columns can be sorted by clicking on the column title. For the "Citation" column, the sorting is based on the content, (the context before the citation), not on the citation itself.

In the "Extra information ..." column some visual indication of the editable part could be helpful.

Wish: selecting an entry (or a button in the line) in the GUI could move the cursor in the document to the entry.

getCitationGroupsSortedWithinPartitions	back to summary
public List<CitationGroup> getCitationGroupsSortedWithinPartitions(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks) throws NoDocumentException, com.sun.star.lang.WrappedTargetException Return citation groups in visual order within (but not across) XText partitions. This is (1) sufficient for combineCiteMarkers which looks for consecutive XTextRanges within each XText, (2) not confused by multicolumn layout or multipage display.

getCitationGroupsSortedWithinPartitions

back to summary

public List<CitationGroup> getCitationGroupsSortedWithinPartitions(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks) throws NoDocumentException, com.sun.star.lang.WrappedTargetException

Return citation groups in visual order within (but not across) XText partitions.

This is (1) sufficient for combineCiteMarkers which looks for consecutive XTextRanges within each XText, (2) not confused by multicolumn layout or multipage display.

getCitationRanges	back to summary
public List<RangeForOverlapCheck<CitationGroupId>> getCitationRanges(com.sun.star.text.XTextDocument doc, OOStyle style) throws NoDocumentException, com.sun.star.lang.WrappedTargetException

getFillCursorForCitationGroup	back to summary
public com.sun.star.text.XTextCursor getFillCursorForCitationGroup(com.sun.star.text.XTextDocument doc, CitationGroup group) throws NoDocumentException, com.sun.star.lang.WrappedTargetException, CreationException

getJStyleCitationRanges	back to summary
public List<RangeForOverlapCheck<CitationGroupId>> getJStyleCitationRanges(com.sun.star.text.XTextDocument doc) throws NoDocumentException, com.sun.star.lang.WrappedTargetException Returns:List<RangeForOverlapCheck<CitationGroupId>> A RangeForOverlapCheck for each citation group. result.size() == nRefMarks

getMarkRange	back to summary
public Optional<com.sun.star.text.XTextRange> getMarkRange(com.sun.star.text.XTextDocument doc, CitationGroup group) throws NoDocumentException, com.sun.star.lang.WrappedTargetException ranges controlled by citation groups should not overlap with each other. Returns:Optional<com.sun.star.text.XTextRange> Optional.empty() if the reference mark is missing.

getMarkRange

back to summary

public Optional<com.sun.star.text.XTextRange> getMarkRange(com.sun.star.text.XTextDocument doc, CitationGroup group) throws NoDocumentException, com.sun.star.lang.WrappedTargetException

ranges controlled by citation groups should not overlap with each other.

Returns:Optional<com.sun.star.text.XTextRange>: Optional.empty() if the reference mark is missing.

getReferenceMarkCitationRanges	back to summary
private List<RangeForOverlapCheck<CitationGroupId>> getReferenceMarkCitationRanges(com.sun.star.text.XTextDocument doc) throws NoDocumentException, com.sun.star.lang.WrappedTargetException Returns:List<RangeForOverlapCheck<CitationGroupId>> A RangeForOverlapCheck for each non-JStyle citation represented by a Writer reference mark.

getVisuallySortedCitationGroups	back to summary
private List<CitationGroup> getVisuallySortedCitationGroups(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks, FunctionalTextViewCursor fcursor) throws com.sun.star.lang.WrappedTargetException, NoDocumentException Parameters mapFootnotesToFootnoteMarks:boolean If true, sort reference marks in footnotes as if they appeared at the corresponding footnote mark. Returns:List<CitationGroup> citation groups sorted by their visual positions. Limitation: for two column layout visual (top-down, left-right) order does not match the expected (textual) order.

getVisuallySortedCitationGroups

back to summary

private List<CitationGroup> getVisuallySortedCitationGroups(com.sun.star.text.XTextDocument doc, boolean mapFootnotesToFootnoteMarks, FunctionalTextViewCursor fcursor) throws com.sun.star.lang.WrappedTargetException, NoDocumentException

Parameters

mapFootnotesToFootnoteMarks:boolean: If true, sort reference marks in footnotes as if they appeared at the corresponding footnote mark.

Returns:List<CitationGroup>

citation groups sorted by their visual positions. Limitation: for two column layout visual (top-down, left-right) order does not match the expected (textual) order.

imposeGlobalOrder	back to summary
public void imposeGlobalOrder(com.sun.star.text.XTextDocument doc, FunctionalTextViewCursor fcursor) throws com.sun.star.lang.WrappedTargetException, NoDocumentException

rangeOverlapsToMessage	back to summary
pack-priv static String rangeOverlapsToMessage(List<RangeOverlap<RangeForOverlapCheck<CitationGroupId>>> overlaps)

readCitationGroupsFromDocument	back to summary
private static Map<CitationGroupId, CitationGroup> readCitationGroupsFromDocument(Backend52 backend, com.sun.star.text.XTextDocument doc, List<String> citationGroupNames) throws com.sun.star.lang.WrappedTargetException, NoDocumentException

removeCitationGroup	back to summary
public void removeCitationGroup(CitationGroup group, com.sun.star.text.XTextDocument doc) throws com.sun.star.lang.WrappedTargetException, NoDocumentException, com.sun.star.beans.NotRemoveableException Remove `group` both from the document and notify `citationGroups`

removeCitationGroups	back to summary
public void removeCitationGroups(List<CitationGroup> citationGroups, com.sun.star.text.XTextDocument doc) throws com.sun.star.lang.WrappedTargetException, NoDocumentException, com.sun.star.beans.NotRemoveableException

viewCursorRanges	back to summary
public List<RangeForOverlapCheck<CitationGroupId>> viewCursorRanges(com.sun.star.text.XTextDocument doc)

public Class OOFrontend

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail