]> git.lyx.org Git - lyx.git/blobdiff - src/TocBackend.cpp
prepare Qt 5.6 builds
[lyx.git] / src / TocBackend.cpp
index 602a82726be3e5a7f573854307c0fa9d7c08102e..9bd435f2f209283245b5ae9d7ad2ef9c7115a5ff 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.
  */
 
 #include "Buffer.h"
 #include "BufferParams.h"
-#include "debug.h"
+#include "Cursor.h"
 #include "FloatList.h"
 #include "FuncRequest.h"
+#include "InsetList.h"
 #include "Layout.h"
 #include "LyXAction.h"
 #include "Paragraph.h"
+#include "ParIterator.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;
 
-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, docstring const & t, FuncRequest action) :
+       dit_(dit), depth_(d), str_(s), tooltip_(t), output_(output_active),
+       action_(action)
 {
 }
 
 
 int TocItem::id() const
 {
-       return par_it_->id();
+       return dit_.paragraph().id();
 }
 
 
-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::asString() const
+// convert a DocIterator into an argument to LFUN_PARAGRAPH_GOTO 
+docstring paragraph_goto_arg(DocIterator const & dit)
 {
-       return docstring(4 * depth_, ' ') + str_;
+       CursorSlice const & s = dit.innerTextSlice();
+       return convert<docstring>(s.paragraph().id()) + ' ' +
+               convert<docstring>(s.pos());
 }
 
+} // namespace anon
 
 FuncRequest TocItem::action() const
 {
-       return FuncRequest(LFUN_PARAGRAPH_GOTO, convert<string>(id()));
+       if (action_.action() == LFUN_UNKNOWN_ACTION) {
+               return FuncRequest(LFUN_PARAGRAPH_GOTO, paragraph_goto_arg(dit_));
+       } else
+               return action_;
 }
 
 
+///////////////////////////////////////////////////////////////////////////
+//
+// Toc implementation
+//
+///////////////////////////////////////////////////////////////////////////
+
+TocIterator Toc::item(DocIterator const & dit) 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;
+       }
+       return it;
+}
+
+
+///////////////////////////////////////////////////////////////////////////
+//
+// TocBuilder implementation
+//
+///////////////////////////////////////////////////////////////////////////
+
+TocBuilder::TocBuilder(shared_ptr<Toc> toc)
+       : toc_(toc ? toc : lyx::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)
+{
+       // 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();
+}
+
+
+
+///////////////////////////////////////////////////////////////////////////
+//
+// TocBuilderStore implementation
+//
+///////////////////////////////////////////////////////////////////////////
+
+shared_ptr<TocBuilder> TocBuilderStore::get(string const & type,
+                                                                                       shared_ptr<Toc> toc)
+{
+       map_t::const_iterator it = map_.find(type);
+       if (it == map_.end()) {
+               it = map_.insert(std::make_pair(type,
+                                                                       lyx::make_shared<TocBuilder>(toc))).first;
+       }
+       return it->second;
+}
+
+
+
 ///////////////////////////////////////////////////////////////////////////
 //
 // TocBackend implementation
 //
 ///////////////////////////////////////////////////////////////////////////
 
-Toc const & TocBackend::toc(std::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);
-       BOOST_ASSERT(it != tocs_.end());
+       LASSERT(it != tocs_.end(), { return lyx::make_shared<Toc>(); });
+       return it->second;
+}
 
+
+shared_ptr<Toc> TocBackend::toc(string const & type)
+{
+       TocList::const_iterator it = tocs_.find(type);
+       if (it == tocs_.end()) {
+               it = tocs_.insert(std::make_pair(type, lyx::make_shared<Toc>())).first;
+       }
        return it->second;
 }
 
 
-void TocBackend::updateItem(ParConstIterator const & par_it)
+shared_ptr<TocBuilder> TocBackend::builder(string const & type)
+{
+       return builders_.get(type, toc(type));
+}
+
+
+// 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)
 {
-       if (toc("tableofcontents").empty()) {
+       // 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
-               lyxerr << "TocBackend::updateItem called but the TOC is empty!"
-                       << std::endl;
-               return;
+               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);
+       TocIterator 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();
+       //
+       // 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() == Inset::OPTARG_CODE) {
+               if (inset.lyxCode() == ARG_CODE) {
+                       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 += ' ';
+                       inset.asInsetText()->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::update(bool output_active, UpdateType utype)
 {
+       for (TocList::iterator it = tocs_.begin(); it != tocs_.end(); ++it)
+               it->second->clear();
        tocs_.clear();
-
-       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));
-               }
+       builders_.clear();
+       if (!buffer_->isInternal()) {
+               DocIterator dit;
+               buffer_->inset().addToToc(dit, output_active, utype);
        }
 }
 
 
-TocIterator const TocBackend::item(std::string const & type,
-               ParConstIterator const & par_it) const
+TocIterator 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());
-
-       Toc const & toc_vector = toclist_it->second;
-       TocIterator last = toc_vector.begin();
-       TocIterator it = toc_vector.end();
-       if (it == last)
-               return it;
-
-       --it;
-
-       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;
-       }
-
-       // We are before the first Toc Item:
-       return last;
+       // We will try to make the best of it in release mode
+       LASSERT(toclist_it != tocs_.end(), toclist_it = tocs_.begin());
+       return toclist_it->second->item(dit);
 }
 
 
-void TocBackend::writePlaintextTocList(string const & type, odocstream & os) const
+void TocBackend::writePlaintextTocList(string const & type,
+        odocstringstream & os, size_t max_length) 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() << '\n';
+               TocIterator ccit = cit->second->begin();
+               TocIterator end = cit->second->end();
+               for (; ccit != end; ++ccit) {
+                       os << ccit->asString() << from_utf8("\n");
+                       if (os.str().size() > max_length)
+                               break;
+               }
        }
 }
 
 
+docstring TocBackend::outlinerName(std::string const & type) const
+{
+       return translateIfPossible(
+           buffer_->params().documentClass().outlinerName(type));
+}
+
+
 } // namespace lyx