]> git.lyx.org Git - lyx.git/blobdiff - src/TocBackend.cpp
Merge branch 'master' of git.lyx.org:lyx
[lyx.git] / src / TocBackend.cpp
index a66b307d5d9e3e7595a42d71847fc904d8f2cc4c..2bbdab3c12252620c5a4ab96c4e3aa560b520e2c 100644 (file)
@@ -6,6 +6,7 @@
  * \author Jean-Marc Lasgouttes
  * \author Angus Leeming
  * \author Abdelrazak Younes
+ * \author Guillaume Munch
  *
  * Full author contact details are available in file CREDITS.
  */
@@ -16,6 +17,7 @@
 
 #include "Buffer.h"
 #include "BufferParams.h"
+#include "Cursor.h"
 #include "FloatList.h"
 #include "FuncRequest.h"
 #include "InsetList.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 {
 
+
 ///////////////////////////////////////////////////////////////////////////
 //
 // TocItem implementation
@@ -45,7 +49,9 @@ namespace lyx {
 ///////////////////////////////////////////////////////////////////////////
 
 TocItem::TocItem(DocIterator const & dit, int d, docstring const & s,
-       docstring const & t) : dit_(dit), depth_(d), str_(s), tooltip_(t)
+                 bool output_active, docstring const & t, FuncRequest action)
+       : dit_(dit), depth_(d), str_(s), tooltip_(t), output_(output_active),
+         action_(action)
 {
 }
 
@@ -56,43 +62,150 @@ int TocItem::id() const
 }
 
 
-int TocItem::depth() const
+docstring const & TocItem::tooltip() const
 {
-       return depth_;
+       return tooltip_.empty() ? str_ : tooltip_;
 }
 
 
-docstring const & TocItem::str() const
+docstring const TocItem::asString() const
 {
-       return str_;
+       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_;
 }
 
+namespace {
 
-docstring const & TocItem::tooltip() const
+// convert a DocIterator into an argument to LFUN_PARAGRAPH_GOTO 
+docstring paragraph_goto_arg(DocIterator const & dit)
 {
-       return tooltip_;
+       CursorSlice const & s = dit.innerTextSlice();
+       return convert<docstring>(s.paragraph().id()) + ' ' +
+               convert<docstring>(s.pos());
 }
 
+} // namespace anon
 
-docstring const TocItem::asString() const
+FuncRequest TocItem::action() const
 {
-       return docstring(4 * depth_, ' ') + str_;
+       if (action_.action() == LFUN_UNKNOWN_ACTION) {
+               return FuncRequest(LFUN_PARAGRAPH_GOTO, paragraph_goto_arg(dit_));
+       } else
+               return action_;
 }
 
 
-DocIterator const & TocItem::dit() const
+///////////////////////////////////////////////////////////////////////////
+//
+// Toc implementation
+//
+///////////////////////////////////////////////////////////////////////////
+
+Toc::const_iterator TocBackend::findItem(Toc const & toc,
+                                         DocIterator const & dit)
 {
-       return dit_;
+       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;
+       }
+
+       // We are before the first Toc Item:
+       return last;
 }
 
 
-FuncRequest TocItem::action() const
+Toc::iterator TocBackend::findItem(Toc & toc, int depth, docstring const & str)
+{
+       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;
+}
+
+
+///////////////////////////////////////////////////////////////////////////
+//
+// TocBuilder implementation
+//
+///////////////////////////////////////////////////////////////////////////
+
+TocBuilder::TocBuilder(shared_ptr<Toc> toc)
+       : toc_(toc ? toc : make_shared<Toc>()),
+         stack_()
+{
+       LATTEST(toc);
+}
+
+void TocBuilder::pushItem(DocIterator const & dit, docstring const & s,
+                          bool output_active, bool is_captioned)
+{
+       toc_->push_back(TocItem(dit, stack_.size(), s, output_active));
+       frame f = {
+               toc_->size() - 1, //pos
+               is_captioned, //is_captioned
+       };
+       stack_.push(f);
+}
+
+void TocBuilder::captionItem(DocIterator const & dit, docstring const & s,
+                             bool output_active)
 {
-       string const arg = convert<string>(dit_.paragraph().id())
-               + ' ' + convert<string>(dit_.pos());
-       return FuncRequest(LFUN_PARAGRAPH_GOTO, arg);
+       // first show the float before moving to the caption
+       docstring arg = "paragraph-goto " + paragraph_goto_arg(dit);
+       if (!stack_.empty())
+               arg = "paragraph-goto " +
+                       paragraph_goto_arg((*toc_)[stack_.top().pos].dit_) + ";" + arg;
+       FuncRequest func(LFUN_COMMAND_SEQUENCE, arg);
+
+       if (!stack_.empty() && !stack_.top().is_captioned) {
+               // The float we entered has not yet been assigned a caption.
+               // Assign the caption string to it.
+               TocItem & captionable = (*toc_)[stack_.top().pos];
+               captionable.str(s);
+               captionable.setAction(func);
+               stack_.top().is_captioned = true;
+       } else {
+               // This is a new entry.
+               pop();
+               // the dit is at the float's level, e.g. for the contextual menu of
+               // outliner entries
+               DocIterator captionable_dit = dit;
+               captionable_dit.pop_back();
+               pushItem(captionable_dit, s, output_active, true);
+               (*toc_)[stack_.top().pos].setAction(func);
+       }
 }
 
+void TocBuilder::pop()
+{
+       if (!stack_.empty())
+               stack_.pop();
+}
+
+
 
 ///////////////////////////////////////////////////////////////////////////
 //
@@ -100,28 +213,45 @@ FuncRequest TocItem::action() const
 //
 ///////////////////////////////////////////////////////////////////////////
 
-Toc const & TocBackend::toc(string const & type) const
+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(), /**/);
-
+       LASSERT(it != tocs_.end(), { return make_shared<Toc>(); });
        return it->second;
 }
 
 
-Toc & TocBackend::toc(string const & type)
+shared_ptr<Toc> TocBackend::toc(string const & type)
 {
-       return tocs_[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;
 }
 
 
-bool TocBackend::updateItem(DocIterator const & dit)
+TocBuilder & TocBackend::builder(string const & type)
 {
-       if (dit.paragraph().layout().toclevel == Layout::NOT_IN_TOC)
+       auto p = make_unique<TocBuilder>(toc(type));
+       return * builders_.insert(make_pair(type, move(p))).first->second;
+}
+
+
+// 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)
+{
+       // 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()) {
+       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!");
@@ -131,115 +261,87 @@ bool TocBackend::updateItem(DocIterator const & dit)
        BufferParams const & bufparams = buffer_->params();
        const int min_toclevel = bufparams.documentClass().min_toclevel();
 
-       TocIterator toc_item = item("tableofcontents", dit);
+       Toc::const_iterator toc_item = item("tableofcontents", dit);
 
        docstring tocstring;
 
        // For each paragraph, traverse its insets and let them add
        // their toc items
+       //
+       // FIXME: This is supposed to accomplish the same as the body of
+       // InsetText::iterateForToc(), probably
        Paragraph & par = toc_item->dit_.paragraph();
        InsetList::const_iterator it = par.insetList().begin();
        InsetList::const_iterator end = par.insetList().end();
        for (; it != end; ++it) {
                Inset & inset = *it->inset;
                if (inset.lyxCode() == ARG_CODE) {
+                       tocstring = par.labelString();
                        if (!tocstring.empty())
-                               break;
-                       Paragraph const & inset_par =
-                               *static_cast<InsetArgument&>(inset).paragraphs().begin();
-                       if (!par.labelString().empty())
-                               tocstring = par.labelString() + ' ';
-                       tocstring += inset_par.asString(AS_STR_INSETS);
+                               tocstring += ' ';
+                       inset.asInsetText()->text().forOutliner(tocstring,TOC_ENTRY_LENGTH);
                        break;
                }
        }
 
-       int const toclevel = par.layout().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 = par.asString(AS_STR_LABEL | AS_STR_INSETS);
+               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::update(bool output_active, UpdateType utype)
 {
+       for (TocList::iterator it = tocs_.begin(); it != tocs_.end(); ++it)
+               it->second->clear();
        tocs_.clear();
+       builders_.clear();
        if (!buffer_->isInternal()) {
                DocIterator dit;
-               buffer_->inset().addToToc(dit);
+               buffer_->inset().addToToc(dit, output_active, utype);
        }
 }
 
 
-TocIterator TocBackend::item(string const & type,
-               DocIterator const & dit) 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?
-       LASSERT(toclist_it != tocs_.end(), /**/);
-       return toclist_it->second.item(dit);
+       // 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);
 }
 
 
-TocIterator Toc::item(DocIterator const & dit) const
+void TocBackend::writePlaintextTocList(string const & type,
+        odocstringstream & os, size_t max_length) const
 {
-       TocIterator last = begin();
-       TocIterator it = end();
-       if (it == last)
-               return it;
-
-       --it;
-
-       DocIterator dit_text = dit;
-       if (dit_text.inMathed()) {
-               // We are only interested in text so remove the math CursorSlice.
-               while (dit_text.inMathed())
-                       dit_text.pop_back();
-       }
-
-       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;
-       }
-
-       // We are before the first Toc Item:
-       return last;
-}
-
-
-Toc::iterator Toc::item(int depth, docstring const & str)
-{
-       if (empty())
-               return end();
-       iterator it = begin();
-       iterator itend = end();
-       for (; it != itend; ++it) {
-               if (it->depth() == depth && it->str() == str)
-                       break;
+       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;
+               }
        }
-       return it;
 }
 
 
-void TocBackend::writePlaintextTocList(string const & type, odocstream & os) const
+docstring TocBackend::outlinerName(string const & type) const
 {
-       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() << from_utf8("\n");
-       }
+       return translateIfPossible(
+           buffer_->params().documentClass().outlinerName(type));
 }