* \author Jean-Marc Lasgouttes
* \author Angus Leeming
* \author Abdelrazak Younes
+ * \author Guillaume Munch
*
* Full author contact details are available in file CREDITS.
*/
#include "Buffer.h"
#include "BufferParams.h"
-#include "FloatList.h"
-#include "FuncRequest.h"
-#include "LyXAction.h"
+#include "IndicesList.h"
+#include "InsetList.h"
#include "Paragraph.h"
-#include "debug.h"
+#include "TextClass.h"
-#include "insets/InsetOptArg.h"
+#include "insets/InsetArgument.h"
-#include "support/convert.h"
+#include "support/debug.h"
+#include "support/docstream.h"
+#include "support/gettext.h"
+#include "support/lassert.h"
+#include "support/lstrings.h"
+using namespace std;
-namespace lyx {
-using std::vector;
-using std::string;
+namespace lyx {
///////////////////////////////////////////////////////////////////////////
+//
// TocItem implementation
+//
+///////////////////////////////////////////////////////////////////////////
-TocItem::TocItem(ParConstIterator const & par_it, int d,
- docstring const & s)
- : par_it_(par_it), depth_(d), str_(s)
+TocItem::TocItem(DocIterator const & dit, int d, docstring const & s,
+ bool output_active, FuncRequest const & action)
+ : dit_(dit), depth_(d), str_(s), output_(output_active),
+ action_(action)
{
-/*
- if (!uid_.empty())
- return;
-
- size_t pos = s.find(" ");
- if (pos == string::npos) {
- // Non labelled item
- uid_ = s;
- return;
- }
-
- string s2 = s.substr(0, pos);
-
- if (s2 == "Chapter" || s2 == "Part") {
- size_t pos2 = s.find(" ", pos + 1);
- if (pos2 == string::npos) {
- // Unnumbered Chapter?? This should not happen.
- uid_ = s.substr(pos + 1);
- return;
- }
- // Chapter or Part
- uid_ = s.substr(pos2 + 1);
- return;
- }
- // Numbered Item.
- uid_ = s.substr(pos + 1);
- */
}
-bool const TocItem::isValid() const
+
+int TocItem::id() const
{
- return depth_ != -1;
+ return dit_.paragraph().id();
}
-int const TocItem::id() const
+docstring const TocItem::asString() const
{
- return par_it_->id();
+ static char_type const cross = 0x2716; // ✖ U+2716 HEAVY MULTIPLICATION X
+ static char_type const thin = 0x2009; // U+2009 THIN SPACE
+ docstring prefix;
+ if (!output_) {
+ prefix += cross;
+ prefix += thin;
+ }
+ return prefix + str_;
}
-int const TocItem::depth() const
+FuncRequest TocItem::action() const
{
- return depth_;
+ if (action_.action() == LFUN_UNKNOWN_ACTION) {
+ return FuncRequest(LFUN_PARAGRAPH_GOTO, dit_.paragraphGotoArgument());
+ } else
+ return action_;
}
-docstring const & TocItem::str() const
+///////////////////////////////////////////////////////////////////////////
+//
+// TocBackend implementation
+//
+///////////////////////////////////////////////////////////////////////////
+
+Toc::const_iterator TocBackend::findItem(Toc const & toc,
+ DocIterator const & dit)
{
- return str_;
-}
+ Toc::const_iterator last = toc.begin();
+ Toc::const_iterator it = toc.end();
+ if (it == last)
+ return it;
+ --it;
+ DocIterator dit_text = dit.getInnerText();
+ for (; it != last; --it) {
+ // We verify that we don't compare contents of two
+ // different document. This happens when you
+ // have parent and child documents.
+ if (&it->dit()[0].inset() != &dit_text[0].inset())
+ continue;
+ if (it->dit() <= dit_text)
+ return it;
+ }
-docstring const TocItem::asString() const
-{
- return docstring(4 * depth_, ' ') + str_;
+ // We are before the first Toc Item:
+ return last;
}
-FuncRequest TocItem::action() const
+Toc::iterator TocBackend::findItem(Toc & toc, int depth, docstring const & str)
{
- return FuncRequest(LFUN_PARAGRAPH_GOTO, convert<string>(id()));
+ if (toc.empty())
+ return toc.end();
+ Toc::iterator it = toc.begin();
+ Toc::iterator itend = toc.end();
+ for (; it != itend; ++it) {
+ if (it->depth() == depth && it->str() == str)
+ break;
+ }
+ return it;
}
+shared_ptr<Toc const> TocBackend::toc(string const & type) const
+{
+ // Is the type already supported?
+ TocList::const_iterator it = tocs_.find(type);
+ LASSERT(it != tocs_.end(), { return make_shared<Toc>(); });
+ return it->second;
+}
+shared_ptr<Toc> TocBackend::toc(string const & type)
+{
+ // std::map::insert only really performs the insertion if the key is not
+ // already bound, and otherwise returns an iterator to the element already
+ // there, see manual.
+ return tocs_.insert({type, make_shared<Toc>()}).first->second;
+}
-///////////////////////////////////////////////////////////////////////////
-// TocBackend implementation
-Toc const & TocBackend::toc(std::string const & type) const
+TocBuilder & TocBackend::builder(string const & type)
{
- // Is the type already supported?
- TocList::const_iterator it = tocs_.find(type);
- BOOST_ASSERT(it != tocs_.end());
-
- return it->second;
+ auto p = make_unique<TocBuilder>(toc(type));
+ return * builders_.insert(make_pair(type, move(p))).first->second;
}
-void TocBackend::updateItem(ParConstIterator const & par_it)
+// FIXME: This function duplicates functionality from InsetText::iterateForToc.
+// Both have their own way of computing the TocItem for "tableofcontents". The
+// TocItem creation and update should be made in a dedicated function and
+// updateItem should be rewritten to uniformly update the matching items from
+// all TOCs.
+bool TocBackend::updateItem(DocIterator const & dit_in)
{
- // TODO should not happen,
- // a call to TocBackend::update() is missing somewhere
- if (toc("tableofcontents").empty())
- return;
+ // we need a text
+ DocIterator dit = dit_in.getInnerText();
+
+ if (dit.text()->getTocLevel(dit.pit()) == Layout::NOT_IN_TOC)
+ return false;
+
+ if (toc("tableofcontents")->empty()) {
+ // FIXME: should not happen,
+ // a call to TocBackend::update() is missing somewhere
+ LYXERR0("TocBackend::updateItem called but the TOC is empty!");
+ return false;
+ }
BufferParams const & bufparams = buffer_->params();
- const int min_toclevel = bufparams.getTextClass().min_toclevel();
+ const int min_toclevel = bufparams.documentClass().min_toclevel();
- TocIterator toc_item = item("tableofcontents", par_it);
+ Toc::const_iterator toc_item = item("tableofcontents", dit);
docstring tocstring;
// For each paragraph, traverse its insets and let them add
// their toc items
- InsetList::const_iterator it = toc_item->par_it_->insetlist.begin();
- InsetList::const_iterator end = toc_item->par_it_->insetlist.end();
- for (; it != end; ++it) {
- Inset & inset = *it->inset;
- if (inset.lyxCode() == Inset::OPTARG_CODE) {
+ //
+ // FIXME: This is supposed to accomplish the same as the body of
+ // InsetText::iterateForToc(), probably
+ Paragraph & par = toc_item->dit().paragraph();
+ for (auto const & table : par.insetList())
+ if (InsetArgument const * arg = table.inset->asInsetArgument()) {
+ tocstring = par.labelString();
if (!tocstring.empty())
- break;
- Paragraph const & par =
- *static_cast<InsetOptArg&>(inset).paragraphs().begin();
- if (!toc_item->par_it_->getLabelstring().empty())
- tocstring = toc_item->par_it_->getLabelstring() + ' ';
- tocstring += par.asString(*buffer_, false);
+ tocstring += ' ';
+ arg->text().forOutliner(tocstring,TOC_ENTRY_LENGTH);
break;
}
- }
- int const toclevel = toc_item->par_it_->layout()->toclevel;
- if (toclevel != Layout::NOT_IN_TOC
- && toclevel >= min_toclevel
+ int const toclevel = toc_item->dit().text()->
+ getTocLevel(toc_item->dit().pit());
+ if (toclevel != Layout::NOT_IN_TOC && toclevel >= min_toclevel
&& tocstring.empty())
- tocstring = toc_item->par_it_->asString(*buffer_, true);
+ par.forOutliner(tocstring, TOC_ENTRY_LENGTH);
- const_cast<TocItem &>(*toc_item).str_ = tocstring;
+ support::truncateWithEllipsis(tocstring, TOC_ENTRY_LENGTH);
+ const_cast<TocItem &>(*toc_item).str(tocstring);
+
+ buffer_->updateTocItem("tableofcontents", dit);
+ return true;
}
-void TocBackend::update()
+void TocBackend::reset()
{
+ for (auto const & t: tocs_)
+ t.second->clear();
tocs_.clear();
+ builders_.clear();
+ resetOutlinerNames();
+}
- BufferParams const & bufparams = buffer_->params();
- const int min_toclevel = bufparams.getTextClass().min_toclevel();
-
- Toc & toc = tocs_["tableofcontents"];
- ParConstIterator pit = buffer_->par_iterator_begin();
- ParConstIterator end = buffer_->par_iterator_end();
- for (; pit != end; ++pit) {
-
- // the string that goes to the toc (could be the optarg)
- docstring tocstring;
-
- // For each paragraph, traverse its insets and let them add
- // their toc items
- InsetList::const_iterator it = pit->insetlist.begin();
- InsetList::const_iterator end = pit->insetlist.end();
- for (; it != end; ++it) {
- Inset & inset = *it->inset;
- inset.addToToc(tocs_, *buffer_, pit);
- switch (inset.lyxCode()) {
- case Inset::OPTARG_CODE: {
- if (!tocstring.empty())
- break;
- Paragraph const & par =
- *static_cast<InsetOptArg&>(inset).paragraphs().begin();
- if (!pit->getLabelstring().empty())
- tocstring = pit->getLabelstring() + ' ';
- tocstring += par.asString(*buffer_, false);
- break;
- }
- default:
- break;
- }
- }
- /// now the toc entry for the paragraph
- int const toclevel = pit->layout()->toclevel;
- if (toclevel != Layout::NOT_IN_TOC
- && toclevel >= min_toclevel) {
- // insert this into the table of contents
- if (tocstring.empty())
- tocstring = pit->asString(*buffer_, true);
- toc.push_back(TocItem(pit, toclevel - min_toclevel,
- tocstring));
- }
- }
+void TocBackend::update(bool output_active, UpdateType utype)
+{
+ reset();
+ if (buffer_->isInternal())
+ return;
+
+ DocIterator dit;
+ buffer_->inset().addToToc(dit, output_active, utype, *this);
}
-TocIterator const TocBackend::item(std::string const & type,
- ParConstIterator const & par_it) const
+Toc::const_iterator TocBackend::item(string const & type,
+ DocIterator const & dit) const
{
TocList::const_iterator toclist_it = tocs_.find(type);
// Is the type supported?
- BOOST_ASSERT(toclist_it != tocs_.end());
+ // We will try to make the best of it in release mode
+ LASSERT(toclist_it != tocs_.end(), toclist_it = tocs_.begin());
+ return findItem(*toclist_it->second, dit);
+}
- Toc const & toc_vector = toclist_it->second;
- TocIterator last = toc_vector.begin();
- TocIterator it = toc_vector.end();
- if (it == last)
- return it;
- --it;
+void TocBackend::writePlaintextTocList(string const & type,
+ odocstringstream & os, size_t max_length) const
+{
+ TocList::const_iterator cit = tocs_.find(type);
+ if (cit != tocs_.end()) {
+ Toc::const_iterator ccit = cit->second->begin();
+ Toc::const_iterator end = cit->second->end();
+ for (; ccit != end; ++ccit) {
+ os << ccit->asString() << from_utf8("\n");
+ if (os.str().size() > max_length)
+ break;
+ }
+ }
+}
- ParConstIterator par_it_text = par_it;
- if (par_it_text.inMathed())
- // It would be better to do
- // par_it_text.backwardInset();
- // but this method does not exist.
- while (par_it_text.inMathed())
- par_it_text.backwardPos();
- for (; it != last; --it) {
- // We verify that we don't compare contents of two
- // different document. This happens when you
- // have parent and child documents.
- if (&it->par_it_[0].inset() != &par_it_text[0].inset())
- continue;
- if (it->par_it_ <= par_it_text)
- return it;
+docstring TocBackend::outlinerName(string const & type) const
+{
+ map<string, docstring>::const_iterator const it
+ = outliner_names_.find(type);
+ if (it != outliner_names_.end())
+ return it->second;
+
+ // Legacy treatment of index:... type
+ if (support::prefixIs(type, "index:")) {
+ string const itype = support::split(type, ':');
+ IndicesList const & indiceslist = buffer_->params().indiceslist();
+ Index const * index = indiceslist.findShortcut(from_utf8(itype));
+ docstring indextype = _("unknown type!");
+ if (index)
+ indextype = index->index();
+ return support::bformat(_("Index Entries (%1$s)"), indextype);
}
- // We are before the first Toc Item:
- return last;
+ LYXERR0("Missing OutlinerName for " << type << "!");
+ return from_utf8(type);
}
-void TocBackend::writePlaintextTocList(string const & type, odocstream & os) const
+void TocBackend::resetOutlinerNames()
{
- TocList::const_iterator cit = tocs_.find(type);
- if (cit != tocs_.end()) {
- TocIterator ccit = cit->second.begin();
- TocIterator end = cit->second.end();
- for (; ccit != end; ++ccit)
- os << ccit->asString() << '\n';
- }
+ outliner_names_.clear();
+ // names from this document class
+ for (auto const & name
+ : buffer_->params().documentClass().outlinerNames())
+ addName(name.first, translateIfPossible(name.second));
+ // Hardcoded types
+ addName("tableofcontents", _("Table of Contents"));
+ addName("change", _("Changes"));
+ addName("senseless", _("Senseless"));
+ addName("citation", _("Citations"));
+ addName("label", _("Labels and References"));
+ addName("brokenrefs", _("Broken References and Citations"));
+ // Customizable, but the corresponding insets have no layout definition
+ addName("child", _("Child Documents"));
+ addName("graphics", _("Graphics"));
+ addName("equation", _("Equations"));
+ addName("external", _("External Material"));
+ addName("math-macro", _("Math Macros"));
+ addName("nomencl", _("Nomenclature Entries"));
+}
+
+
+void TocBackend::addName(string const & type, docstring const & name)
+{
+ if (name.empty())
+ return;
+ // only inserts if the key does not exist
+ outliner_names_.insert({type, name});
+}
+
+
+bool TocBackend::isOther(std::string const & type)
+{
+ return type == "graphics"
+ || type == "note"
+ || type == "branch"
+ || type == "change"
+ || type == "label"
+ || type == "citation"
+ || type == "equation"
+ || type == "footnote"
+ || type == "marginalnote"
+ || type == "nomencl"
+ || type == "listings"
+ || type == "math-macro"
+ || type == "external"
+ || type == "senseless"
+ || type == "index"
+ || type.substr(0,6) == "index:";
}