]> git.lyx.org Git - lyx.git/blobdiff - src/insets/InsetSpecialChar.cpp
Loop refactoring
[lyx.git] / src / insets / InsetSpecialChar.cpp
index ef3826d97563b32125611b8e5a587a4a18884def..3ecdaf12e94315f2f4bbb438d0183e5e70154603 100644 (file)
 #include "InsetSpecialChar.h"
 
 #include "Dimension.h"
+#include "Encoding.h"
 #include "Font.h"
+#include "Language.h"
 #include "LaTeXFeatures.h"
 #include "Lexer.h"
 #include "MetricsInfo.h"
+#include "output_xhtml.h"
+#include "xml.h"
+#include "texstream.h"
 
 #include "frontends/FontMetrics.h"
+#include "frontends/NullPainter.h"
 #include "frontends/Painter.h"
 
 #include "support/debug.h"
@@ -32,7 +38,7 @@ namespace lyx {
 
 
 InsetSpecialChar::InsetSpecialChar(Kind k)
-       : Inset(0), kind_(k)
+       : Inset(nullptr), kind_(k)
 {}
 
 
@@ -42,43 +48,202 @@ InsetSpecialChar::Kind InsetSpecialChar::kind() const
 }
 
 
+docstring InsetSpecialChar::toolTip(BufferView const &, int, int) const
+{
+       docstring message;
+       switch (kind_) {
+               case ALLOWBREAK:
+                       message = from_ascii("Optional Line Break (ZWSP)");
+                       break;
+               case LIGATURE_BREAK:
+                       message = from_ascii("Ligature Break (ZWNJ)");
+                       break;
+               case END_OF_SENTENCE:
+                       message = from_ascii("End of Sentence");
+                       break;
+               case HYPHENATION:
+                       message = from_ascii("Hyphenation Point");
+                       break;
+               case SLASH:
+                       message = from_ascii("Breakable Slash");
+                       break;
+               case NOBREAKDASH:
+                       message = from_ascii("Protected Hyphen (SHY)");
+                       break;
+               case LDOTS:
+               case MENU_SEPARATOR:
+               case PHRASE_LYX:
+               case PHRASE_TEX:
+               case PHRASE_LATEX2E:
+               case PHRASE_LATEX:
+                       // no tooltip for these ones.
+                       break;
+       }
+       return message;
+}
+
+
+Inset::RowFlags InsetSpecialChar::rowFlags() const
+{
+       switch (kind_) {
+       case ALLOWBREAK:
+       case HYPHENATION:
+       case SLASH:
+               // these are the elements that allow line breaking
+               return CanBreakAfter;
+       case NOBREAKDASH:
+       case END_OF_SENTENCE:
+       case LIGATURE_BREAK:
+       case LDOTS:
+       case MENU_SEPARATOR:
+       case PHRASE_LYX:
+       case PHRASE_TEX:
+       case PHRASE_LATEX2E:
+       case PHRASE_LATEX:
+               break;
+       }
+       return Inline;
+}
+
+
+namespace {
+
+// helper function: draw text and update x.
+void drawChar(PainterInfo & pi, int & x, int const y, char_type ch)
+{
+       FontInfo font = pi.base.font;
+       font.setPaintColor(pi.textColor(font.realColor()));
+       pi.pain.text(x, y, ch, font);
+       x += theFontMetrics(font).width(ch);
+}
+
+
+void drawLogo(PainterInfo & pi, int & x, int const y, InsetSpecialChar::Kind kind)
+{
+       FontInfo const & font = pi.base.font;
+       int const em = theFontMetrics(font).em();
+       switch (kind) {
+       case InsetSpecialChar::PHRASE_LYX:
+               /** Reference macro:
+                *  \providecommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\\@};
+                */
+               drawChar(pi, x, y, 'L');
+               x -= em / 6;
+               drawChar(pi, x, y + em / 4, 'Y');
+               x -= em / 8;
+               drawChar(pi, x, y, 'X');
+               break;
+
+       case InsetSpecialChar::PHRASE_TEX: {
+               /** Reference macro:
+                *  \def\TeX{T\kern-.1667em\lower.5ex\hbox{E}\kern-.125emX\@}
+                */
+               int const ex = theFontMetrics(font).xHeight();
+               drawChar(pi, x, y, 'T');
+               x -= em / 6;
+               drawChar(pi, x, y + ex / 2, 'E');
+               x -= em / 8;
+               drawChar(pi, x, y, 'X');
+               break;
+       }
+       case InsetSpecialChar::PHRASE_LATEX2E:
+               /** Reference macro:
+                *  \DeclareRobustCommand{\LaTeXe}{\mbox{\m@th
+                *    \if b\expandafter\@car\f@series\@nil\boldmath\fi
+                *    \LaTeX\kern.15em2$_{\textstyle\varepsilon}$}}
+                */
+               drawLogo(pi, x, y, InsetSpecialChar::PHRASE_LATEX);
+               x += 3 * em / 20;
+               drawChar(pi, x, y, '2');
+               // ε U+03B5 GREEK SMALL LETTER EPSILON
+               drawChar(pi, x, y + em / 4, char_type(0x03b5));
+               break;
+
+       case InsetSpecialChar::PHRASE_LATEX: {
+               /** Reference macro:
+                * \DeclareRobustCommand{\LaTeX}{L\kern-.36em%
+                *        {\sbox\z@ T%
+                *         \vbox to\ht\z@{\hbox{\check@mathfonts
+                *                              \fontsize\sf@size\z@
+                *                              \math@fontsfalse\selectfont
+                *                              A}%
+                *                        \vss}%
+                *        }%
+                *        \kern-.15em%
+                *        \TeX}
+                */
+               drawChar(pi, x, y, 'L');
+               x -= 9 * em / 25;
+               PainterInfo pi2 = pi;
+               pi2.base.font.decSize().decSize();
+               drawChar(pi2, x, y - em / 5, 'A');
+               x -= 3 * em / 20;
+               drawLogo(pi, x, y, InsetSpecialChar::PHRASE_TEX);
+               break;
+       }
+       default:
+               LYXERR0("No information for drawing logo " << kind);
+       }
+}
+
+} // namespace
+
+
 void InsetSpecialChar::metrics(MetricsInfo & mi, Dimension & dim) const
 {
        frontend::FontMetrics const & fm =
                theFontMetrics(mi.base.font);
        dim.asc = fm.maxAscent();
-       dim.des = fm.maxDescent();
+       dim.des = 0;
+       dim.wid = 0;
 
-       string s;
+       docstring s;
        switch (kind_) {
+               case ALLOWBREAK:
+                       dim.asc = fm.xHeight();
+                       dim.des = fm.descent('g');
+                       dim.wid = fm.em() / 8;
+                       break;
                case LIGATURE_BREAK:
-                       s = "|";
+                       s = from_ascii("|");
                        break;
                case END_OF_SENTENCE:
-                       s = ".";
+                       s = from_ascii(".");
                        break;
                case LDOTS:
-                       s = ". . .";
+                       s = from_ascii(". . .");
                        break;
                case MENU_SEPARATOR:
-                       s = " x ";
+                       // ▹  U+25B9 WHITE RIGHT-POINTING SMALL TRIANGLE
+                       // There is a \thinspace on each side of the triangle
+                       dim.wid = 2 * fm.em() / 6 + fm.width(char_type(0x25B9));
                        break;
                case HYPHENATION:
-                       s = "-";
+                       dim.wid = fm.width(from_ascii("-"));
+                       if (dim.wid > 5)
+                               dim.wid -= 2; // to make it look shorter
                        break;
                case SLASH:
-                       s = "/";
+                       s = from_ascii("/");
+                       dim.des = fm.descent(s[0]);
                        break;
                case NOBREAKDASH:
-                       s = "-";
+                       s = from_ascii("-");
+                       break;
+               case PHRASE_LYX:
+               case PHRASE_TEX:
+               case PHRASE_LATEX2E:
+               case PHRASE_LATEX:
+                       dim.asc = fm.maxAscent();
+                       dim.des = fm.maxDescent();
+                       frontend::NullPainter np;
+                       PainterInfo pi(mi.base.bv, np);
+                       pi.base.font = mi.base.font;
+                       drawLogo(pi, dim.wid, 0, kind_);
                        break;
        }
-       docstring ds(s.begin(), s.end());
-       dim.wid = fm.width(ds);
-       if (kind_ == HYPHENATION && dim.wid > 5)
-               dim.wid -= 2; // to make it look shorter
-       
-       setDimCache(mi, dim);
+       if (dim.wid == 0)
+               dim.wid = fm.width(s);
 }
 
 
@@ -93,6 +258,18 @@ void InsetSpecialChar::draw(PainterInfo & pi, int x, int y) const
                pi.pain.text(x, y, char_type('-'), font);
                break;
        }
+       case ALLOWBREAK:
+       {
+               // A small vertical line
+               int const asc = theFontMetrics(pi.base.font).xHeight();
+               int const desc = theFontMetrics(pi.base.font).descent('g');
+               int const x0 = x; // x + 1; // FIXME: incline,
+               int const x1 = x; // x - 1; // similar to LibreOffice?
+               int const y0 = y + desc;
+               int const y1 = y - asc / 3;
+               pi.pain.line(x0, y1, x1, y0, Color_special);
+               break;
+       }
        case LIGATURE_BREAK:
        {
                font.setColor(Color_special);
@@ -118,18 +295,13 @@ void InsetSpecialChar::draw(PainterInfo & pi, int x, int y) const
                frontend::FontMetrics const & fm =
                        theFontMetrics(font);
 
-               // A triangle the width and height of an 'x'
-               int w = fm.width(char_type('x'));
-               int ox = fm.width(char_type(' ')) + x;
-               int h = fm.ascent(char_type('x'));
-               int xp[4], yp[4];
-
-               xp[0] = ox;     yp[0] = y;
-               xp[1] = ox;     yp[1] = y - h;
-               xp[2] = ox + w; yp[2] = y - h/2;
-               xp[3] = ox;     yp[3] = y;
-
-               pi.pain.lines(xp, yp, 4, Color_special);
+               // There is a \thinspace on each side of the triangle
+               x += fm.em() / 6;
+               // ▹ U+25B9 WHITE RIGHT-POINTING SMALL TRIANGLE
+               // ◃ U+25C3 WHITE LEFT-POINTING SMALL TRIANGLE
+               char_type const c = pi.ltr_pos ? 0x25B9 : 0x25C3;
+               font.setColor(Color_special);
+               pi.pain.text(x, y, c, font);
                break;
        }
        case SLASH:
@@ -144,113 +316,191 @@ void InsetSpecialChar::draw(PainterInfo & pi, int x, int y) const
                pi.pain.text(x, y, char_type('-'), font);
                break;
        }
+       case PHRASE_LYX:
+       case PHRASE_TEX:
+       case PHRASE_LATEX2E:
+       case PHRASE_LATEX:
+               drawLogo(pi, x, y, kind_);
+               break;
        }
 }
 
 
-// In lyxf3 this will be just LaTeX
 void InsetSpecialChar::write(ostream & os) const
 {
        string command;
        switch (kind_) {
        case HYPHENATION:
-               command = "\\-";
+               command = "softhyphen";
+               break;
+       case ALLOWBREAK:
+               command = "allowbreak";
                break;
        case LIGATURE_BREAK:
-               command = "\\textcompwordmark{}";
+               command = "ligaturebreak";
                break;
        case END_OF_SENTENCE:
-               command = "\\@.";
+               command = "endofsentence";
                break;
        case LDOTS:
-               command = "\\ldots{}";
+               command = "ldots";
                break;
        case MENU_SEPARATOR:
-               command = "\\menuseparator";
+               command = "menuseparator";
                break;
        case SLASH:
-               command = "\\slash{}";
+               command = "breakableslash";
                break;
        case NOBREAKDASH:
-               command = "\\nobreakdash-";
+               command = "nobreakdash";
+               break;
+       case PHRASE_LYX:
+               command = "LyX";
+               break;
+       case PHRASE_TEX:
+               command = "TeX";
+               break;
+       case PHRASE_LATEX2E:
+               command = "LaTeX2e";
+               break;
+       case PHRASE_LATEX:
+               command = "LaTeX";
                break;
        }
        os << "\\SpecialChar " << command << "\n";
 }
 
 
-// This function will not be necessary when lyx3
 void InsetSpecialChar::read(Lexer & lex)
 {
        lex.next();
        string const command = lex.getString();
 
-       if (command == "\\-")
+       if (command == "softhyphen")
                kind_ = HYPHENATION;
-       else if (command == "\\textcompwordmark{}")
+       else if (command == "allowbreak")
+               kind_ = ALLOWBREAK;
+       else if (command == "ligaturebreak")
                kind_ = LIGATURE_BREAK;
-       else if (command == "\\@.")
+       else if (command == "endofsentence")
                kind_ = END_OF_SENTENCE;
-       else if (command == "\\ldots{}")
+       else if (command == "ldots")
                kind_ = LDOTS;
-       else if (command == "\\menuseparator")
+       else if (command == "menuseparator")
                kind_ = MENU_SEPARATOR;
-       else if (command == "\\slash{}")
+       else if (command == "breakableslash")
                kind_ = SLASH;
-       else if (command == "\\nobreakdash-")
+       else if (command == "nobreakdash")
                kind_ = NOBREAKDASH;
+       else if (command == "LyX")
+               kind_ = PHRASE_LYX;
+       else if (command == "TeX")
+               kind_ = PHRASE_TEX;
+       else if (command == "LaTeX2e")
+               kind_ = PHRASE_LATEX2E;
+       else if (command == "LaTeX")
+               kind_ = PHRASE_LATEX;
        else
                lex.printError("InsetSpecialChar: Unknown kind: `$$Token'");
 }
 
 
-int InsetSpecialChar::latex(odocstream & os,
-                           OutputParams const & rp) const
+void InsetSpecialChar::latex(otexstream & os,
+                            OutputParams const & rp) const
 {
+       bool const rtl = rp.local_font->isRightToLeft();
+       bool const utf8 = rp.encoding->iconvName() == "UTF-8";
+       string lswitch = "";
+       string lswitche = "";
+       if (rtl && !rp.use_polyglossia) {
+               lswitch = "\\L{";
+               lswitche = "}";
+               if (rp.local_font->language()->lang() == "arabic_arabi"
+                   || rp.local_font->language()->lang() == "farsi")
+                       lswitch = "\\textLR{";
+       }
+
        switch (kind_) {
        case HYPHENATION:
                os << "\\-";
                break;
+       case ALLOWBREAK:
+               // U+200B not yet supported by utf8 inputenc
+               os << "\\LyXZeroWidthSpace" << termcmd;
+               break;
        case LIGATURE_BREAK:
-               os << "\\textcompwordmark{}";
+               if (utf8)
+                       // U+200C ZERO WIDTH NON-JOINER
+                       os.put(0x200c);
+               else
+                       os << "\\textcompwordmark" << termcmd;
                break;
        case END_OF_SENTENCE:
                os << "\\@.";
                break;
        case LDOTS:
-               os << "\\ldots{}";
+               os << "\\ldots" << termcmd;
                break;
        case MENU_SEPARATOR:
-               if (rp.local_font->isRightToLeft())
-                       os << "\\lyxarrow*{}";
+               if (rtl)
+                       os << "\\lyxarrow*";
                else
-                       os << "\\lyxarrow{}";
+                       os << "\\lyxarrow";
+               os << termcmd;
                break;
        case SLASH:
-               os << "\\slash{}";
+               os << "\\slash" << termcmd;
                break;
        case NOBREAKDASH:
                if (rp.moving_arg)
                        os << "\\protect";
                os << "\\nobreakdash-";
                break;
+       case PHRASE_LYX:
+               if (rp.moving_arg)
+                       os << "\\protect";
+               os << lswitch << "\\LyX" << termcmd << lswitche;
+               break;
+       case PHRASE_TEX:
+               if (rp.moving_arg)
+                       os << "\\protect";
+               os << lswitch << "\\TeX" << termcmd << lswitche;
+               break;
+       case PHRASE_LATEX2E:
+               if (rp.moving_arg)
+                       os << "\\protect";
+               os << lswitch << "\\LaTeXe" << termcmd << lswitche;
+               break;
+       case PHRASE_LATEX:
+               if (rp.moving_arg)
+                       os << "\\protect";
+               os << lswitch << "\\LaTeX" << termcmd << lswitche;
+               break;
        }
-       return 0;
 }
 
 
-int InsetSpecialChar::plaintext(odocstream & os, OutputParams const &) const
+int InsetSpecialChar::plaintext(odocstringstream & os,
+        OutputParams const &, size_t) const
 {
        switch (kind_) {
        case HYPHENATION:
-       case LIGATURE_BREAK:
                return 0;
+       case ALLOWBREAK:
+               // U+200B ZERO WIDTH SPACE (ZWSP)
+               os.put(0x200b);
+               return 1;
+       case LIGATURE_BREAK:
+               // U+200C ZERO WIDTH NON-JOINER
+               os.put(0x200c);
+               return 1;
        case END_OF_SENTENCE:
                os << '.';
                return 1;
        case LDOTS:
-               os << "...";
-               return 3;
+               // … U+2026 HORIZONTAL ELLIPSIS
+               os.put(0x2026);
+               return 1;
        case MENU_SEPARATOR:
                os << "->";
                return 2;
@@ -258,89 +508,173 @@ int InsetSpecialChar::plaintext(odocstream & os, OutputParams const &) const
                os << '/';
                return 1;
        case NOBREAKDASH:
-               os << '-';
+               // ‑ U+2011 NON-BREAKING HYPHEN
+               os.put(0x2011);
                return 1;
+       case PHRASE_LYX:
+               os << "LyX";
+               return 3;
+       case PHRASE_TEX:
+               os << "TeX";
+               return 3;
+       case PHRASE_LATEX2E:
+               os << "LaTeX2";
+               // ε U+03B5 GREEK SMALL LETTER EPSILON
+               os.put(0x03b5);
+               return 7;
+       case PHRASE_LATEX:
+               os << "LaTeX";
+               return 5;
        }
        return 0;
 }
 
 
-int InsetSpecialChar::docbook(odocstream & os, OutputParams const &) const
+void InsetSpecialChar::docbook(XMLStream & xs, OutputParams const &) const
 {
        switch (kind_) {
-       case HYPHENATION:
+    case HYPHENATION:
+       // Soft hyphen.
+        xs << XMLStream::ESCAPE_NONE << "&#xAD;";
+        break;
+    case ALLOWBREAK:
+       // Zero-width space
+        xs << XMLStream::ESCAPE_NONE << "&#x200B;";
+        break;
        case LIGATURE_BREAK:
+               // Zero width non-joiner
+               xs << XMLStream::ESCAPE_NONE << "&#x200C;";
                break;
        case END_OF_SENTENCE:
-               os << '.';
+               xs << '.';
                break;
        case LDOTS:
-               os << "...";
+               // &hellip;
+               xs << XMLStream::ESCAPE_NONE << "&#x2026;";
                break;
        case MENU_SEPARATOR:
-               os << "&lyxarrow;";
+               // &rArr;, right arrow.
+               xs << XMLStream::ESCAPE_NONE << "&#x21D2;";
                break;
        case SLASH:
-               os << '/';
+               // &frasl;, fractional slash.
+               xs << XMLStream::ESCAPE_NONE << "&#x2044;";
                break;
+               // Non-breaking hyphen.
        case NOBREAKDASH:
-               os << '-';
+               xs << XMLStream::ESCAPE_NONE << "&#x2011;";
+               break;
+       case PHRASE_LYX:
+               xs << "LyX";
+               break;
+       case PHRASE_TEX:
+               xs << "TeX";
+               break;
+       case PHRASE_LATEX2E:
+               // Lower-case epsilon.
+               xs << "LaTeX2" << XMLStream::ESCAPE_NONE << "&#x03b5;";
+               break;
+       case PHRASE_LATEX:
+               xs << "LaTeX";
                break;
        }
-       return 0;
 }
 
 
-docstring InsetSpecialChar::xhtml(odocstream & os, OutputParams const &) const
+docstring InsetSpecialChar::xhtml(XMLStream & xs, OutputParams const &) const
 {
        switch (kind_) {
        case HYPHENATION:
+               break;
+       case ALLOWBREAK:
+               xs << XMLStream::ESCAPE_NONE << "&#8203;";
+               break;
        case LIGATURE_BREAK:
+               xs << XMLStream::ESCAPE_NONE << "&#8204;";
                break;
        case END_OF_SENTENCE:
-               os << '.';
+               xs << '.';
                break;
        case LDOTS:
-               os << "&hellip;";
+               xs << XMLStream::ESCAPE_NONE << "&hellip;";
                break;
        case MENU_SEPARATOR:
-               os << "&rArr;";
+               xs << XMLStream::ESCAPE_NONE << "&rArr;";
                break;
        case SLASH:
-               os << "&frasl;";
+               xs << XMLStream::ESCAPE_NONE << "&frasl;";
                break;
        case NOBREAKDASH:
-               os << '-';
+               xs << XMLStream::ESCAPE_NONE << "&#8209;";
+               break;
+       case PHRASE_LYX:
+               xs << "LyX";
+               break;
+       case PHRASE_TEX:
+               xs << "TeX";
+               break;
+       case PHRASE_LATEX2E:
+               xs << "LaTeX2" << XMLStream::ESCAPE_NONE << "&#x3b5;";
+               break;
+       case PHRASE_LATEX:
+               xs << "LaTeX";
                break;
        }
        return docstring();
 }
 
 
-void InsetSpecialChar::tocString(odocstream & os) const
+void InsetSpecialChar::toString(odocstream & os) const
+{
+       switch (kind_) {
+       case ALLOWBREAK:
+       case LIGATURE_BREAK:
+               // Do not output ZERO WIDTH SPACE and ZERO WIDTH NON JOINER here
+               // Spell checker would choke on it.
+               return;
+       default:
+               break;
+       }
+       odocstringstream ods;
+       plaintext(ods, OutputParams(0));
+       os << ods.str();
+}
+
+
+void InsetSpecialChar::forOutliner(docstring & os, size_t const,
+                                                                  bool const) const
 {
-       plaintext(os, OutputParams(0));
+       odocstringstream ods;
+       plaintext(ods, OutputParams(0));
+       os += ods.str();
 }
 
 
 void InsetSpecialChar::validate(LaTeXFeatures & features) const
 {
+       if (kind_ == ALLOWBREAK)
+               features.require("lyxzerowidthspace");
        if (kind_ == MENU_SEPARATOR)
                features.require("lyxarrow");
        if (kind_ == NOBREAKDASH)
                features.require("amsmath");
+       if (kind_ == PHRASE_LYX)
+               features.require("LyX");
 }
 
 
 bool InsetSpecialChar::isChar() const
 {
-       return true;
+       return kind_ != HYPHENATION && kind_ != LIGATURE_BREAK;
 }
 
 
 bool InsetSpecialChar::isLetter() const
 {
-       return kind_ == HYPHENATION || kind_ == LIGATURE_BREAK;
+       return kind_ == HYPHENATION || kind_ == LIGATURE_BREAK
+               || kind_ == NOBREAKDASH
+               || kind_ == PHRASE_LYX || kind_ == PHRASE_LATEX
+               || kind_ == PHRASE_TEX || kind_ == PHRASE_LATEX2E;
 }
 
 
@@ -351,7 +685,8 @@ bool InsetSpecialChar::isLineSeparator() const
        // Paragraph::stripLeadingSpaces nukes the characters which
        // have this property. I leave the code here, since it should
        // eventually be made to work. (JMarc 20020327)
-       return kind_ == HYPHENATION || kind_ == MENU_SEPARATOR;
+       return kind_ == HYPHENATION || kind_ == ALLOWBREAK
+           || kind_ == MENU_SEPARATOR || kind_ == SLASH;
 #else
        return false;
 #endif