]> git.lyx.org Git - lyx.git/blobdiff - src/insets/InsetRef.cpp
Fix text direction of references with XeTeX/bidi
[lyx.git] / src / insets / InsetRef.cpp
index 680323cc4a48deec7efdaaaea0a26c70885eb936..82db322320aaae7d5d89bba6537ecfa69b65a120 100644 (file)
 #include "BufferParams.h"
 #include "Cursor.h"
 #include "DispatchResult.h"
+#include "FuncStatus.h"
 #include "InsetLabel.h"
+#include "Language.h"
 #include "LaTeXFeatures.h"
 #include "LyX.h"
 #include "OutputParams.h"
 #include "output_xhtml.h"
 #include "ParIterator.h"
 #include "sgml.h"
+#include "texstream.h"
 #include "TocBackend.h"
 
 #include "support/debug.h"
@@ -37,25 +40,27 @@ namespace lyx {
 
 
 InsetRef::InsetRef(Buffer * buf, InsetCommandParams const & p)
-       : InsetCommand(buf, p)
+       : InsetCommand(buf, p), broken_(false)
 {}
 
 
 InsetRef::InsetRef(InsetRef const & ir)
-       : InsetCommand(ir)
+       : InsetCommand(ir), broken_(false)
 {}
 
 
 bool InsetRef::isCompatibleCommand(string const & s) {
        //FIXME This is likely not the best way to handle this.
        //But this stuff is hardcoded elsewhere already.
-       return s == "ref" 
+       return s == "ref"
                || s == "pageref"
-               || s == "vref" 
+               || s == "vref"
                || s == "vpageref"
                || s == "formatted"
+               || s == "prettyref" // for InsetMathRef FIXME
                || s == "eqref"
-               || s == "nameref";
+               || s == "nameref"
+               || s == "labelonly";
 }
 
 
@@ -66,36 +71,103 @@ ParamInfo const & InsetRef::findInfo(string const & /* cmdName */)
                param_info_.add("name", ParamInfo::LATEX_OPTIONAL);
                param_info_.add("reference", ParamInfo::LATEX_REQUIRED,
                                ParamInfo::HANDLING_ESCAPE);
+               param_info_.add("plural", ParamInfo::LYX_INTERNAL);
+               param_info_.add("caps", ParamInfo::LYX_INTERNAL);
+               param_info_.add("noprefix", ParamInfo::LYX_INTERNAL);
        }
        return param_info_;
 }
 
 
+void InsetRef::doDispatch(Cursor & cur, FuncRequest & cmd)
+{
+       string const inset = cmd.getArg(0);
+       string const arg   = cmd.getArg(1);
+       string pstring;
+       if (cmd.action() == LFUN_INSET_MODIFY && inset == "ref") {
+               if (arg == "toggle-plural")
+                       pstring = "plural";
+               else if (arg == "toggle-caps")
+                       pstring = "caps";
+               else if (arg == "toggle-noprefix")
+                       pstring = "noprefix";
+       }
+       // otherwise not for us
+       if (pstring.empty())
+               return InsetCommand::doDispatch(cur, cmd);
+
+       bool const isSet = (getParam(pstring) == "true");
+       setParam(pstring, from_ascii(isSet ? "false"  : "true"));
+}
+
+
+bool InsetRef::getStatus(Cursor & cur, FuncRequest const & cmd,
+       FuncStatus & status) const
+{
+       if (cmd.action() != LFUN_INSET_MODIFY)
+               return InsetCommand::getStatus(cur, cmd, status);
+       if (cmd.getArg(0) != "ref")
+               return InsetCommand::getStatus(cur, cmd, status);
+
+       string const arg = cmd.getArg(1);
+       string pstring;
+       if (arg == "toggle-plural")
+               pstring = "plural";
+       else if (arg == "toggle-caps")
+               pstring = "caps";
+       if (!pstring.empty()) {
+               status.setEnabled(buffer().params().use_refstyle &&
+                       params().getCmdName() == "formatted");
+               bool const isSet = (getParam(pstring) == "true");
+               status.setOnOff(isSet);
+               return true;
+       }
+       if (arg == "toggle-noprefix") {
+               status.setEnabled(params().getCmdName() == "labelonly");
+               bool const isSet = (getParam("noprefix") == "true");
+               status.setOnOff(isSet);
+               return true;
+       }
+       // otherwise not for us
+       return InsetCommand::getStatus(cur, cmd, status);
+}
+
+
+namespace {
+
+void capitalize(docstring & s) {
+       char_type t = uppercase(s[0]);
+       s[0] = t;
+}
+
+} // namespace
+
+
 // the ref argument is the label name we are referencing.
 // we expect ref to be in the form: pfx:suffix.
 //
-// if it isn't, then we can't produce a formatted reference, 
+// if it isn't, then we can't produce a formatted reference,
 // so we return "\ref" and put ref into label.
 //
-// for refstyle, we return "\pfxcmd", and put suffix into 
+// for refstyle, we return "\pfxcmd", and put suffix into
 // label and pfx into prefix. this is because refstyle expects
 // the command: \pfxcmd{suffix}.
-// 
+//
 // for prettyref, we return "\prettyref" and put ref into label
 // and pfx into prefix. this is because prettyref uses the whole
 // label, thus: \prettyref{pfx:suffix}.
 //
-docstring InsetRef::getFormattedCmd(docstring const & ref, 
-       docstring & label, docstring & prefix) const
+docstring InsetRef::getFormattedCmd(docstring const & ref,
+       docstring & label, docstring & prefix, docstring const & caps) const
 {
        static docstring const defcmd = from_ascii("\\ref");
        static docstring const prtcmd = from_ascii("\\prettyref");
-       
+
        label = split(ref, prefix, ':');
 
        // we have to have xxx:xxxxx...
        if (label.empty()) {
-               LYXERR0("Label `" << ref << "' contains no prefix.");
+               LYXERR0("Label `" << ref << "' contains no `:' separator.");
                label = ref;
                prefix = from_ascii("");
                return defcmd;
@@ -106,7 +178,7 @@ docstring InsetRef::getFormattedCmd(docstring const & ref,
                label = ref;
                return defcmd;
        }
-       
+
        if (!buffer().params().use_refstyle) {
                // \prettyref uses the whole label
                label = ref;
@@ -124,6 +196,9 @@ docstring InsetRef::getFormattedCmd(docstring const & ref,
                        return defcmd;
                }
        }
+       if (caps == "true") {
+               capitalize(prefix);
+       }
        return from_ascii("\\") + prefix + from_ascii("ref");
 }
 
@@ -133,16 +208,16 @@ docstring InsetRef::getEscapedLabel(OutputParams const & rp) const
        InsetCommandParams const & p = params();
        ParamInfo const & pi = p.info();
        ParamInfo::ParamData const & pd = pi["reference"];
-       return p.prepareCommand(rp, getParam("reference"), pd.handling());              
+       return p.prepareCommand(rp, getParam("reference"), pd.handling());
 }
 
 
 void InsetRef::latex(otexstream & os, OutputParams const & rp) const
 {
-       string const cmd = getCmdName();
-       docstring const data = getEscapedLabel(rp);
+       string const cmd = getCmdName();
+       docstring const data = getEscapedLabel(rp);
 
-       if (rp.inulemcmd)
+       if (rp.inulemcmd > 0)
                os << "\\mbox{";
 
        if (cmd == "eqref" && buffer().params().use_refstyle) {
@@ -151,15 +226,34 @@ void InsetRef::latex(otexstream & os, OutputParams const & rp) const
                // "equation n". if one wants \eqref, one can get it by using a
                // formatted label in this case.
                os << '(' << from_ascii("\\ref{") << data << from_ascii("})");
-       } 
+       }
        else if (cmd == "formatted") {
                docstring label;
                docstring prefix;
-               docstring const fcmd = getFormattedCmd(data, label, prefix);
-               os << fcmd << '{' << label << '}';
+               docstring const fcmd =
+                       getFormattedCmd(data, label, prefix, getParam("caps"));
+               os << fcmd;
+               if (buffer().params().use_refstyle && getParam("plural") == "true")
+                   os << "[s]";
+               os << '{' << label << '}';
+       }
+       else if (cmd == "labelonly") {
+               docstring const & ref = getParam("reference");
+               if (getParam("noprefix") != "true")
+                       os << ref;
+               else {
+                       docstring prefix;
+                       docstring suffix = split(ref, prefix, ':');
+                       if (suffix.empty()) {
+                   LYXERR0("Label `" << ref << "' contains no `:' separator.");
+                               os << ref;
+                       } else {
+                               os << suffix;
+                       }
+               }
        }
        else {
-               // We don't want to output p_["name"], since that is only used 
+               // We don't want to output p_["name"], since that is only used
                // in docbook. So we construct new params, without it, and use that.
                InsetCommandParams p(REF_CODE, cmd);
                docstring const ref = getParam("reference");
@@ -167,7 +261,7 @@ void InsetRef::latex(otexstream & os, OutputParams const & rp) const
                os << p.getCommand(rp);
        }
 
-       if (rp.inulemcmd)
+       if (rp.inulemcmd > 0)
                os << "}";
 }
 
@@ -206,10 +300,10 @@ int InsetRef::docbook(odocstream & os, OutputParams const & runparams) const
 }
 
 
-docstring InsetRef::xhtml(XHTMLStream & xs, OutputParams const &) const
+docstring InsetRef::xhtml(XHTMLStream & xs, OutputParams const & op) const
 {
        docstring const & ref = getParam("reference");
-       InsetLabel const * il = buffer().insetLabel(ref);
+       InsetLabel const * il = buffer().insetLabel(ref, true);
        string const & cmd = params().getCmdName();
        docstring display_string;
 
@@ -222,23 +316,33 @@ docstring InsetRef::xhtml(XHTMLStream & xs, OutputParams const &) const
                        // normally, would be "ref on page #", but we have no pages
                        display_string = value;
                else if (cmd == "pageref" || cmd == "vpageref")
-                       // normally would be "on page #", but we have no pages
-                       display_string = _("elsewhere");
+                       // normally would be "on page #", but we have no pages.
+                       display_string = translateIfPossible(from_ascii("elsewhere"),
+                               op.local_font->language()->lang());
                else if (cmd == "eqref")
-                       display_string = bformat(from_ascii("equation (%1$s)"), value);
-               else if (cmd == "formatted"
-                        // we don't really have the ability to handle these 
-                        // properly in XHTML output
-                        || cmd == "nameref")
+                       display_string = '(' + value + ')';
+               else if (cmd == "formatted") {
+                       display_string = il->prettyCounter();
+                       if (buffer().params().use_refstyle && getParam("caps") == "true")
+                               capitalize(display_string);
+                       // it is hard to see what to do about plurals...
+               }
+               else if (cmd == "nameref")
+                       // FIXME We don't really have the ability to handle these
+                       // properly in XHTML output yet (bug #8599).
+                       // It might not be that hard to do. We have the InsetLabel,
+                       // and we can presumably find its paragraph using the TOC.
+                       // But the label might be referencing a section, yet not be
+                       // in that section. So this is not trivial.
                        display_string = il->prettyCounter();
-       } else 
+       } else
                        display_string = ref;
 
        // FIXME What we'd really like to do is to be able to output some
        // appropriate sort of text here. But to do that, we need to associate
        // some sort of counter with the label, and we don't have that yet.
-       string const attr = "href=\"#" + html::cleanAttr(to_utf8(ref)) + "\"";
-       xs << html::StartTag("a", attr);
+       docstring const attr = "href=\"#" + html::cleanAttr(ref) + '"';
+       xs << html::StartTag("a", to_utf8(attr));
        xs << display_string;
        xs << html::EndTag("a");
        return docstring();
@@ -253,7 +357,7 @@ void InsetRef::toString(odocstream & os) const
 }
 
 
-void InsetRef::forToc(docstring & os, size_t) const
+void InsetRef::forOutliner(docstring & os, size_t const, bool const) const
 {
        // There's no need for details in the TOC, and a long label
        // will just get in the way.
@@ -265,48 +369,71 @@ void InsetRef::updateBuffer(ParIterator const & it, UpdateType)
 {
        docstring const & ref = getParam("reference");
        // register this inset into the buffer reference cache.
-       buffer().references(ref).push_back(make_pair(this, it));
+       buffer().addReference(ref, this, it);
 
        docstring label;
+       string const & cmd = getCmdName();
        for (int i = 0; !types[i].latex_name.empty(); ++i) {
-               if (getCmdName() == types[i].latex_name) {
+               if (cmd == types[i].latex_name) {
                        label = _(types[i].short_gui_name);
                        break;
                }
        }
-       label += ref;
-       
+
+       if (cmd != "labelonly")
+               label += ref;
+       else {
+               if (getParam("noprefix") != "true")
+                       label += ref;
+               else {
+                       docstring prefix;
+                       docstring suffix = split(ref, prefix, ':');
+                       if (suffix.empty()) {
+                               label += ref;
+                       } else {
+                               label += suffix;
+                       }
+               }
+       }
+
        if (!buffer().params().isLatex() && !getParam("name").empty()) {
                label += "||";
                label += getParam("name");
        }
-       
-       screen_label_ = label;
-       bool shortened = false;
+
        unsigned int const maxLabelChars = 24;
-       if (screen_label_.size() > maxLabelChars) {
-               screen_label_.erase(maxLabelChars - 3);
-               screen_label_ += "...";
-               shortened = true;
-       }
-       if (shortened)
+       if (label.size() > maxLabelChars) {
                tooltip_ = label;
-       else 
+               support::truncateWithEllipsis(label, maxLabelChars);
+       } else
                tooltip_ = from_ascii("");
+
+       screen_label_ = label;
+       broken_ = false;
 }
 
 
-void InsetRef::addToToc(DocIterator const & cpit, bool output_active) const
+docstring InsetRef::screenLabel() const
+{
+       return (broken_ ? _("BROKEN: ") : docstring()) + screen_label_;
+}
+
+
+void InsetRef::addToToc(DocIterator const & cpit, bool output_active,
+                                               UpdateType, TocBackend & backend) const
 {
        docstring const & label = getParam("reference");
-       if (buffer().insetLabel(label))
+       if (buffer().insetLabel(label)) {
+               broken_ = !buffer().activeLabel(label);
                // This InsetRef has already been taken care of in InsetLabel::addToToc().
                return;
+       }
 
        // It seems that this reference does not point to any valid label.
-       screen_label_ = _("BROKEN: ") + screen_label_;
-       Toc & toc = buffer().tocBackend().toc("label");
-       toc.push_back(TocItem(cpit, 0, screen_label_, output_active));
+
+       broken_ = true;
+       shared_ptr<Toc> toc = backend.toc("label");
+       toc->push_back(TocItem(cpit, 0, screenLabel(), output_active));
 }
 
 
@@ -319,14 +446,15 @@ void InsetRef::validate(LaTeXFeatures & features) const
                docstring const data = getEscapedLabel(features.runparams());
                docstring label;
                docstring prefix;
-               string const fcmd = to_utf8(getFormattedCmd(data, label, prefix));
+               docstring const fcmd =
+                       getFormattedCmd(data, label, prefix, getParam("caps"));
                if (buffer().params().use_refstyle) {
                        features.require("refstyle");
                        if (prefix == "cha")
-                               features.addPreambleSnippet("\\let\\charef=\\chapref");
+                               features.addPreambleSnippet(from_ascii("\\let\\charef=\\chapref"));
                        else if (!prefix.empty()) {
-                               string lcmd = "\\AtBeginDocument{\\providecommand" + 
-                                               fcmd + "[1]{\\ref{" + to_utf8(prefix) + ":#1}}}";
+                               docstring lcmd = "\\AtBeginDocument{\\providecommand" +
+                                               fcmd + "[1]{\\ref{" + prefix + ":#1}}}";
                                features.addPreambleSnippet(lcmd);
                        }
                } else {
@@ -334,7 +462,7 @@ void InsetRef::validate(LaTeXFeatures & features) const
                        // prettyref uses "cha" for chapters, so we provide a kind of
                        // translation.
                        if (prefix == "chap")
-                               features.addPreambleSnippet("\\let\\pr@chap=\\pr@cha");
+                               features.addPreambleSnippet(from_ascii("\\let\\pr@chap=\\pr@cha"));
                }
        } else if (cmd == "eqref" && !buffer().params().use_refstyle)
                // with refstyle, we simply output "(\ref{label})"
@@ -343,32 +471,36 @@ void InsetRef::validate(LaTeXFeatures & features) const
                features.require("nameref");
 }
 
+bool InsetRef::forceLTR(OutputParams const & rp) const
+{
+       // We force LTR for references. However,
+       // * Namerefs are output in the scripts direction
+       //   at least with fontspec/bidi and luabidi, though (see #11518).
+       // * Parentheses are automatically swapped with XeTeX/bidi 
+       //   [not with LuaTeX/luabidi] (see #11626).
+       // FIXME: Re-Audit all other RTL cases.
+       if (rp.useBidiPackage())
+               return false;
+       return (getCmdName() != "nameref" || !buffer().masterParams().useNonTeXFonts);
+}
+
 
-InsetRef::type_info InsetRef::types[] = {
+InsetRef::type_info const InsetRef::types[] = {
        { "ref",       N_("Standard"),              N_("Ref: ")},
        { "eqref",     N_("Equation"),              N_("EqRef: ")},
        { "pageref",   N_("Page Number"),           N_("Page: ")},
        { "vpageref",  N_("Textual Page Number"),   N_("TextPage: ")},
        { "vref",      N_("Standard+Textual Page"), N_("Ref+Text: ")},
+       { "nameref",   N_("Reference to Name"),     N_("NameRef: ")},
        { "formatted", N_("Formatted"),             N_("Format: ")},
-       { "nameref",   N_("Reference to Name"),     N_("NameRef:")},
+       { "labelonly", N_("Label Only"),            N_("Label: ")},
        { "", "", "" }
 };
 
 
-int InsetRef::getType(string const & name)
+docstring InsetRef::getTOCString() const
 {
-       for (int i = 0; !types[i].latex_name.empty(); ++i)
-               if (name == types[i].latex_name)
-                       return i;
-       return 0;
-}
-
-
-string const & InsetRef::getName(int type)
-{
-       return types[type].latex_name;
+       return tooltip_.empty() ? screenLabel() : tooltip_;
 }
 
-
 } // namespace lyx