lyx_mirror/src/mathed/InsetMathRef.cpp
Richard Kimberly Heck cf07d4825f Fix bug #11104. Activate refstyle support for InsetMathRef.
At the moment, there is no support for plurals and capitalization.
A long comment explains why. Support could be added for that without
a format change.
2021-01-05 18:17:53 -05:00

361 lines
9.7 KiB
C++

/**
* \file InsetMathRef.cpp
* This file is part of LyX, the document processor.
* Licence details can be found in the file COPYING.
*
* \author André Pönitz
*
* Full author contact details are available in file CREDITS.
*/
#include <config.h>
#include "InsetMathRef.h"
#include "BufferParams.h"
#include "BufferView.h"
#include "Buffer.h"
#include "Cursor.h"
#include "FuncRequest.h"
#include "FuncStatus.h"
#include "LaTeXFeatures.h"
#include "LyX.h"
#include "MathData.h"
#include "MathFactory.h"
#include "MathStream.h"
#include "MathSupport.h"
#include "ParIterator.h"
#include "xml.h"
#include "insets/InsetCommand.h"
#include "insets/InsetRef.h"
#include "support/debug.h"
#include "support/gettext.h"
#include "support/lstrings.h"
#include "support/textutils.h"
#include <ostream>
using namespace std;
namespace lyx {
InsetMathRef::InsetMathRef(Buffer * buf)
: InsetMathCommand(buf, from_ascii("ref"), false)
{}
InsetMathRef::InsetMathRef(Buffer * buf, docstring const & data)
: InsetMathCommand(buf, data, false)
{}
Inset * InsetMathRef::clone() const
{
return new InsetMathRef(*this);
}
void InsetMathRef::infoize(odocstream & os) const
{
os << "Ref: " << cell(0);
}
void InsetMathRef::doDispatch(Cursor & cur, FuncRequest & cmd)
{
switch (cmd.action()) {
case LFUN_INSET_MODIFY:
if (cmd.getArg(0) == "ref") {
if (cmd.getArg(1) == "changetarget") {
string const oldtarget = cmd.getArg(2);
string const newtarget = cmd.getArg(3);
if (!oldtarget.empty() && !newtarget.empty()
&& asString(cell(0)) == from_utf8(oldtarget))
changeTarget(from_utf8(newtarget));
cur.forceBufferUpdate();
break;
}
MathData ar;
if (createInsetMath_fromDialogStr(cmd.argument(), ar)) {
cur.recordUndo();
Buffer & buf = buffer();
*this = *ar[0].nucleus()->asRefInset();
setBuffer(buf);
break;
}
}
cur.undispatched();
break;
case LFUN_INSET_DIALOG_UPDATE: {
string const data = createDialogStr();
cur.bv().updateDialog("ref", data);
break;
}
case LFUN_MOUSE_RELEASE:
if (cur.selection()) {
cur.undispatched();
break;
}
if (cmd.button() == mouse_button::button3) {
LYXERR0("trying to goto ref '" << to_utf8(asString(cell(0))) << "'");
//FIXME: use DispatchResult argument
lyx::dispatch(FuncRequest(LFUN_LABEL_GOTO, asString(cell(0))));
break;
}
if (cmd.button() == mouse_button::button1) {
// Eventually trigger dialog with button 3, not 1
string const data = createDialogStr();
cur.bv().showDialog("ref", data, this);
break;
}
cur.undispatched();
break;
case LFUN_MOUSE_PRESS: {
bool do_selection = cmd.button() == mouse_button::button1
&& cmd.modifier() == ShiftModifier;
// For some reason the cursor points inside the first cell, which is not
// active.
cur.leaveInset(*this);
cur.bv().mouseSetCursor(cur, do_selection);
break;
}
case LFUN_MOUSE_DOUBLE:
case LFUN_MOUSE_TRIPLE:
// eat other mouse commands
break;
default:
InsetMathCommand::doDispatch(cur, cmd);
break;
}
}
bool InsetMathRef::getStatus(Cursor & cur, FuncRequest const & cmd,
FuncStatus & status) const
{
switch (cmd.action()) {
// we handle these
case LFUN_INSET_MODIFY:
case LFUN_INSET_DIALOG_UPDATE:
case LFUN_MOUSE_RELEASE:
case LFUN_MOUSE_PRESS:
case LFUN_MOUSE_DOUBLE:
case LFUN_MOUSE_TRIPLE:
status.setEnabled(true);
return true;
default:
return InsetMathCommand::getStatus(cur, cmd, status);
}
}
docstring const InsetMathRef::screenLabel() const
{
docstring str;
for (int i = 0; !types[i].latex_name.empty(); ++i) {
if (commandname() == types[i].latex_name) {
str = _(to_utf8(types[i].short_gui_name));
break;
}
}
str += asString(cell(0));
//if (/* !isLatex && */ !cell(0).empty()) {
// str += "||";
// str += asString(cell(1));
//}
return str;
}
void InsetMathRef::validate(LaTeXFeatures & features) const
{
// This really should not happen here but does.
if (!buffer_) {
LYXERR0("Unassigned buffer_ in InsetMathRef::write!");
LYXERR0("LaTeX output may be wrong!");
}
bool const use_refstyle =
buffer_ && buffer().params().use_refstyle;
if (commandname() == "vref" || commandname() == "vpageref")
features.require("varioref");
else if (commandname() == "formatted") {
if (use_refstyle)
features.require("refstyle");
else
features.require("prettyref");
}
// if eqref is used with refstyle, we do our own output
else if (commandname() == "eqref" && use_refstyle)
features.require("amsmath");
else if (commandname() == "nameref")
features.require("nameref");
}
void InsetMathRef::docbook(XMLStream & xs, OutputParams const &) const
{
if (cell(1).empty()) {
docstring attr = from_utf8("linkend=\"") + xml::cleanID(asString(cell(0))) + from_utf8("\"");
xs << xml::CompTag("xref", to_utf8(attr));
} else {
// Link with linkend, as is it within the document (not outside, in which case xlink:href is better suited).
docstring attr = from_utf8("linkend=\"") + xml::cleanID(asString(cell(0))) + from_utf8("\"");
xs << xml::StartTag("link", to_utf8(attr))
<< asString(cell(1))
<< xml::EndTag("link");
}
}
void InsetMathRef::updateBuffer(ParIterator const & it, UpdateType /*utype*/, bool const /*deleted*/)
{
if (!buffer_) {
LYXERR0("InsetMathRef::updateBuffer: no buffer_!");
return;
}
// register this inset into the buffer reference cache.
buffer().addReference(getTarget(), this, it);
}
string const InsetMathRef::createDialogStr() const
{
InsetCommandParams icp(REF_CODE, to_ascii(commandname()));
icp["reference"] = asString(cell(0));
if (!cell(1).empty())
icp["name"] = asString(cell(1));
return InsetCommand::params2string(icp);
}
docstring const InsetMathRef::getTarget() const
{
return asString(cell(0));
}
void InsetMathRef::changeTarget(docstring const & target)
{
InsetCommandParams icp(REF_CODE, to_ascii(commandname()));
icp["reference"] = target;
if (!cell(1).empty())
icp["name"] = asString(cell(1));
MathData ar;
Buffer & buf = buffer();
if (createInsetMath_fromDialogStr(
from_utf8(InsetCommand::params2string(icp)), ar)) {
*this = *ar[0].nucleus()->asRefInset();
// FIXME audit setBuffer calls
setBuffer(buf);
}
}
void InsetMathRef::write(TeXMathStream & os) const
{
docstring const & cmd = commandname();
// This should not happen, but of course it does
if (!buffer_) {
LYXERR0("Unassigned buffer_ in InsetMathRef::write!");
LYXERR0("LaTeX output may be wrong!");
}
bool const use_refstyle =
buffer_ && buffer().params().use_refstyle;
bool special_case = cmd == "formatted" ||
cmd == "labelonly" ||
(cmd == "eqref" && use_refstyle);
// are we writing to the LyX file or not in a special case?
if (!os.latex() || !special_case) {
// if so, then this is easy
InsetMathCommand::write(os);
return;
}
// we need to translate 'formatted' to prettyref or refstyle-type
// commands and just output the label with labelonly
// most of this is borrowed from InsetRef and should be kept in
// sync with that.
ModeSpecifier specifier(os, currentMode(), lockedMode(), asciiOnly());
MathEnsurer ensurer(os, false);
if (use_refstyle && cmd == "eqref") {
// we advertise this as printing "(n)", so we'll do that, at least
// for refstyle, since refstlye's own \eqref prints, by default,
// "equation n". if one wants \eqref, one can get it by using a
// formatted label in this case.
os << '(' << from_ascii("\\ref{") << cell(0) << from_ascii("})");
}
else if (cmd == "formatted") {
if (!use_refstyle)
os << "\\prettyref{" << cell(0) << "}";
else {
odocstringstream ods;
// get the label we are referencing
for (auto const & d : cell(0)) {
ods << d;
}
docstring const ref = ods.str();
/*
At the moment, the 'plural' and 'caps' options will
not work here. The reason is that we handle these as
'internal' LyX argumemts, but those are not handled by
InsetCommandParams::getCommand, which is what is used
in createInsetMath_fromDialogStr to interpret the data
coming from the dialog.
If this is fixed, then what follows will get the info
we need.
Fixing it, I think, would mean sub-classing
InsetCommandParams to InsetRefParams, and the overriding
getCommand.
*******************************************************
// reset
ods.str(docstring());
ods.clear();
// get the options from the optional argument
for (auto const & d : cell(1))
ods << d;
docstring const options = ods.str();
bool const caps = support::contains(options, 'C');
bool const plural = support::contains(options, 's');
*/
docstring label;
docstring prefix;
docstring const fcmd =
InsetRef::getFormattedCmd(ref, label, prefix, true);
os << fcmd;
//if (plural)
// os << "[s]";
os << '{' << label << '}';
}
}
else if (cmd == "labelonly") {
// noprefix does not work here, for reasons given above.
os << cell(0);
}
}
InsetMathRef::ref_type_info InsetMathRef::types[] = {
{ from_ascii("ref"), from_ascii(N_("Standard[[mathref]]")), from_ascii(N_("Ref: "))},
{ from_ascii("eqref"), from_ascii(N_("Equation")), from_ascii(N_("EqRef: "))},
{ from_ascii("pageref"), from_ascii(N_("Page Number")), from_ascii(N_("Page: "))},
{ from_ascii("vpageref"), from_ascii(N_("Textual Page Number")), from_ascii(N_("TextPage: "))},
{ from_ascii("vref"), from_ascii(N_("Standard+Textual Page")), from_ascii(N_("Ref+Text: "))},
{ from_ascii("formatted"), from_ascii(N_("PrettyRef")), from_ascii(N_("FormatRef: "))},
{ from_ascii("nameref"), from_ascii(N_("Reference to Name")), from_ascii(N_("NameRef: "))},
{ from_ascii("labelonly"), from_ascii(N_("Label Only")), from_ascii(N_("Label Only: "))},
{ from_ascii(""), from_ascii(""), from_ascii("") }
};
} // namespace lyx