Oobranch c : ootext and rangesort

src/main/java/org/jabref/model/openoffice/ootext/OOFormat.java

@@ -0,0 +1,80 @@
+package org.jabref.model.openoffice.ootext;
+
+import org.jabref.model.strings.StringUtil;
+
+/**
+ * Helper functions to produce some of the markup as understood by OOTextIntoOO.write
+ *
+ * These do not cover all tags, only those needed to embed markup
+ * from Layout and citation marker formatters into citation markers and
+ * bibliography.
+ */
+public class OOFormat {
+
+    /**
+     * Mark {@code ootext} as using a character locale known to OO.
+     *
+     * @param locale language[-country[-territory]]
+     *
+     * https://www.openoffice.org/api/docs/common/ref/com/sun/star/lang/Locale.html
+     *
+     * The country part is optional.
+     *
+     * The territory part is not only optional, the allowed "codes are vendor and browser-specific",
+     * so probably best to avoid them if possible.
+     *
+     */
+    public static OOText setLocale(OOText ootext, String locale) {
+        return OOText.fromString(String.format("<span lang=\"%s\">", locale) + ootext.toString() + "</span>");
+    }
+
+    /**
+     * Mark {@code ootext} as using the character locale "zxx", which means "no language", "no
+     * linguistic content".
+     *
+     * Used around citation marks, probably to turn off spellchecking.
+     *
+     */
+    public static OOText setLocaleNone(OOText ootext) {
+        return OOFormat.setLocale(ootext, "zxx");
+    }
+
+    /**
+     * Mark {@code ootext} using a character style {@code charStyle}
+     *
+     * @param charStyle Name of a character style known to OO. May be empty for "Standard", which in
+     *                  turn means do not override any properties.
+     *
+     */
+    public static OOText setCharStyle(OOText ootext, String charStyle) {
+        return OOText.fromString(String.format("<span oo:CharStyleName=\"%s\">", charStyle)
+                                 + ootext.toString()
+                                 + "</span>");
+    }
+
+    /**
+     * Mark {@code ootext} as part of a paragraph with style {@code paraStyle}
+     */
+    public static OOText paragraph(OOText ootext, String paraStyle) {
+        if (StringUtil.isNullOrEmpty(paraStyle)) {
+            return paragraph(ootext);
+        }
+        String startTag = String.format("<p oo:ParaStyleName=\"%s\">", paraStyle);
+        return OOText.fromString(startTag + ootext.toString() + "</p>");
+    }
+
+    /**
+     * Mark {@code ootext} as part of a paragraph.
+     */
+    public static OOText paragraph(OOText ootext) {
+        return OOText.fromString("<p>" + ootext.toString() + "</p>");
+    }
+
+    /**
+     * Format an OO cross-reference showing the target's page number as label to a reference mark.
+     */
+    public static OOText formatReferenceToPageNumberOfReferenceMark(String referencMarkName) {
+        String string = String.format("<oo:referenceToPageNumberOfReferenceMark target=\"%s\">", referencMarkName);
+        return OOText.fromString(string);
+    }
+ }

src/main/java/org/jabref/model/openoffice/ootext/OOText.java

@@ -0,0 +1,62 @@
+package org.jabref.model.openoffice.ootext;
+
+import java.util.Objects;
+
+/**
+ * Text with HTML-like markup as understood by OOTextIntoOO.write
+ *
+ * Some of the tags can be added using OOFormat methods. Others come from the layout engine, either
+ * by interpreting LaTeX markup or from settings in the jstyle file.
+ */
+public class OOText {
+
+    private final String data;
+
+    private OOText(String data) {
+        Objects.requireNonNull(data);
+        this.data = data;
+    }
+
+    /* null input is passed through */
+    public static OOText fromString(String string) {
+        if (string == null) {
+            return null;
+        }
+        return new OOText(string);
+    }
+
+    /* null input is passed through */
+    public static String toString(OOText ootext) {
+        if (ootext == null) {
+            return null;
+        }
+        return ootext.data;
+    }
+
+    @Override
+    public String toString() {
+        return data;
+    }
+
+    /* Object.equals */
+    @Override
+    public boolean equals(Object object) {
+
+        if (object == this) {
+            return true;
+        }
+
+        if (!(object instanceof OOText)) {
+            return false;
+        }
+
+        OOText c = (OOText) object;
+
+        return data.equals(c.data);
+    }
+
+    @Override
+    public int hashCode() {
+        return data.hashCode();
+    }
+}