src/buffer_funcs.C

   1 /**
   2  * \file buffer_funcs.C
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author Lars Gullik Bjønnes
   7  * \author Alfredo Braunstein
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  *
  11  */
  12
  13 #include <config.h>
  14
  15 #include "buffer_funcs.h"
  16 #include "buffer.h"
  17 #include "bufferlist.h"
  18 #include "bufferparams.h"
  19 #include "dociterator.h"
  20 #include "counters.h"
  21 #include "errorlist.h"
  22 #include "Floating.h"
  23 #include "FloatList.h"
  24 #include "gettext.h"
  25 #include "language.h"
  26 #include "LaTeX.h"
  27 #include "lyxtextclass.h"
  28 #include "paragraph.h"
  29 #include "paragraph_funcs.h"
  30 #include "ParagraphList.h"
  31 #include "ParagraphParameters.h"
  32 #include "pariterator.h"
  33 #include "lyxvc.h"
  34 #include "texrow.h"
  35 #include "TocBackend.h"
  36 #include "vc-backend.h"
  37
  38 #include "frontends/Alert.h"
  39
  40 #include "insets/insetbibitem.h"
  41
  42 #include "support/filetools.h"
  43 #include "support/fs_extras.h"
  44 #include "support/lyxlib.h"
  45
  46 #include <boost/bind.hpp>
  47 #include <boost/filesystem/operations.hpp>
  48
  49
  50 namespace lyx {
  51
  52 using namespace std;
  53
  54 using support::bformat;
  55 using support::libFileSearch;
  56 using support::makeDisplayPath;
  57 using support::onlyFilename;
  58 using support::onlyPath;
  59 using support::unlink;
  60
  61 using std::min;
  62 using std::string;
  63
  64 namespace Alert = frontend::Alert;
  65 namespace fs = boost::filesystem;
  66
  67 namespace {
  68
  69 bool readFile(Buffer * const b, string const & s)
  70 {
  71         BOOST_ASSERT(b);
  72
  73         // File information about normal file
  74         if (!fs::exists(s)) {
  75                 docstring const file = makeDisplayPath(s, 50);
  76                 docstring text = bformat(_("The specified document\n%1$s"
  77                                                      "\ncould not be read."), file);
  78                 Alert::error(_("Could not read document"), text);
  79                 return false;
  80         }
  81
  82         // Check if emergency save file exists and is newer.
  83         string const e = onlyPath(s) + onlyFilename(s) + ".emergency";
  84
  85         if (fs::exists(e) && fs::exists(s)
  86             && fs::last_write_time(e) > fs::last_write_time(s))
  87         {
  88                 docstring const file = makeDisplayPath(s, 20);
  89                 docstring const text =
  90                         bformat(_("An emergency save of the document "
  91                                   "%1$s exists.\n\n"
  92                                                "Recover emergency save?"), file);
  93                 switch (Alert::prompt(_("Load emergency save?"), text, 0, 2,
  94                                       _("&Recover"),  _("&Load Original"),
  95                                       _("&Cancel")))
  96                 {
  97                 case 0:
  98                         // the file is not saved if we load the emergency file.
  99                         b->markDirty();
 100                         return b->readFile(e);
 101                 case 1:
 102                         break;
 103                 default:
 104                         return false;
 105                 }
 106         }
 107
 108         // Now check if autosave file is newer.
 109         string const a = onlyPath(s) + '#' + onlyFilename(s) + '#';
 110
 111         if (fs::exists(a) && fs::exists(s)
 112             && fs::last_write_time(a) > fs::last_write_time(s))
 113         {
 114                 docstring const file = makeDisplayPath(s, 20);
 115                 docstring const text =
 116                         bformat(_("The backup of the document "
 117                                   "%1$s is newer.\n\nLoad the "
 118                                                "backup instead?"), file);
 119                 switch (Alert::prompt(_("Load backup?"), text, 0, 2,
 120                                       _("&Load backup"), _("Load &original"),
 121                                       _("&Cancel") ))
 122                 {
 123                 case 0:
 124                         // the file is not saved if we load the autosave file.
 125                         b->markDirty();
 126                         return b->readFile(a);
 127                 case 1:
 128                         // Here we delete the autosave
 129                         unlink(a);
 130                         break;
 131                 default:
 132                         return false;
 133                 }
 134         }
 135         return b->readFile(s);
 136 }
 137
 138
 139 } // namespace anon
 140
 141
 142
 143 bool loadLyXFile(Buffer * b, string const & s)
 144 {
 145         BOOST_ASSERT(b);
 146
 147         if (fs::is_readable(s)) {
 148                 if (readFile(b, s)) {
 149                         b->lyxvc().file_found_hook(s);
 150                         if (!fs::is_writable(s))
 151                                 b->setReadonly(true);
 152                         return true;
 153                 }
 154         } else {
 155                 docstring const file = makeDisplayPath(s, 20);
 156                 // Here we probably should run
 157                 if (LyXVC::file_not_found_hook(s)) {
 158                         docstring const text =
 159                                 bformat(_("Do you want to retrieve the document"
 160                                                        " %1$s from version control?"), file);
 161                         int const ret = Alert::prompt(_("Retrieve from version control?"),
 162                                 text, 0, 1, _("&Retrieve"), _("&Cancel"));
 163
 164                         if (ret == 0) {
 165                                 // How can we know _how_ to do the checkout?
 166                                 // With the current VC support it has to be,
 167                                 // a RCS file since CVS do not have special ,v files.
 168                                 RCS::retrieve(s);
 169                                 return loadLyXFile(b, s);
 170                         }
 171                 }
 172         }
 173         return false;
 174 }
 175
 176 // FIXME newFile() should probably be a member method of Application...
 177 Buffer * newFile(string const & filename, string const & templatename,
 178                  bool const isNamed)
 179 {
 180         // get a free buffer
 181         Buffer * b = theBufferList().newBuffer(filename);
 182         BOOST_ASSERT(b);
 183
 184         string tname;
 185         // use defaults.lyx as a default template if it exists.
 186         if (templatename.empty())
 187                 tname = libFileSearch("templates", "defaults.lyx");
 188         else
 189                 tname = templatename;
 190
 191         if (!tname.empty()) {
 192                 if (!b->readFile(tname)) {
 193                         docstring const file = makeDisplayPath(tname, 50);
 194                         docstring const text  = bformat(
 195                                 _("The specified document template\n%1$s\ncould not be read."),
 196                                 file);
 197                         Alert::error(_("Could not read template"), text);
 198                         theBufferList().release(b);
 199                         return 0;
 200                 }
 201         }
 202
 203         if (!isNamed) {
 204                 b->setUnnamed();
 205                 b->setFileName(filename);
 206         }
 207
 208         b->setReadonly(false);
 209         b->fully_loaded(true);
 210         b->updateDocLang(b->params().language);
 211
 212         return b;
 213 }
 214
 215
 216 void bufferErrors(Buffer const & buf, TeXErrors const & terr,
 217                                   ErrorList & errorList)
 218 {
 219         TeXErrors::Errors::const_iterator cit = terr.begin();
 220         TeXErrors::Errors::const_iterator end = terr.end();
 221
 222         for (; cit != end; ++cit) {
 223                 int id_start = -1;
 224                 int pos_start = -1;
 225                 int errorrow = cit->error_in_line;
 226                 bool found = buf.texrow().getIdFromRow(errorrow, id_start,
 227                                                        pos_start);
 228                 int id_end = -1;
 229                 int pos_end = -1;
 230                 do {
 231                         ++errorrow;
 232                         found = buf.texrow().getIdFromRow(errorrow, id_end,
 233                                                           pos_end);
 234                 } while (found && id_start == id_end && pos_start == pos_end);
 235
 236                 errorList.push_back(ErrorItem(from_utf8(cit->error_desc),
 237                         from_utf8(cit->error_text), id_start, pos_start, pos_end));
 238         }
 239 }
 240
 241
 242 string const bufferFormat(Buffer const & buffer)
 243 {
 244         if (buffer.isDocBook())
 245                 return "docbook";
 246         else if (buffer.isLiterate())
 247                 return "literate";
 248         else
 249                 return "latex";
 250 }
 251
 252
 253 int countWords(DocIterator const & from, DocIterator const & to)
 254 {
 255         int count = 0;
 256         bool inword = false;
 257         for (DocIterator dit = from ; dit != to ; dit.forwardPos()) {
 258                 // Copied and adapted from isLetter() in ControlSpellChecker
 259                 if (dit.inTexted()
 260                     && dit.pos() != dit.lastpos()
 261                     && dit.paragraph().isLetter(dit.pos())
 262                     && !dit.paragraph().isDeleted(dit.pos())) {
 263                         if (!inword) {
 264                                 ++count;
 265                                 inword = true;
 266                         }
 267                 } else if (inword)
 268                         inword = false;
 269         }
 270
 271         return count;
 272 }
 273
 274
 275 namespace {
 276
 277 depth_type getDepth(DocIterator const & it)
 278 {
 279         depth_type depth = 0;
 280         for (size_t i = 0 ; i < it.depth() ; ++i)
 281                 if (!it[i].inset().inMathed())
 282                         depth += it[i].paragraph().getDepth() + 1;
 283         // remove 1 since the outer inset does not count
 284         return depth - 1;
 285 }
 286
 287 depth_type getItemDepth(ParIterator const & it)
 288 {
 289         Paragraph const & par = *it;
 290         LYX_LABEL_TYPES const labeltype = par.layout()->labeltype;
 291
 292         if (labeltype != LABEL_ENUMERATE && labeltype != LABEL_ITEMIZE)
 293                 return 0;
 294
 295         // this will hold the lowest depth encountered up to now.
 296         depth_type min_depth = getDepth(it);
 297         ParIterator prev_it = it;
 298         while (true) {
 299                 if (prev_it.pit())
 300                         --prev_it.top().pit();
 301                 else {
 302                         // start of nested inset: go to outer par
 303                         prev_it.pop_back();
 304                         if (prev_it.empty()) {
 305                                 // start of document: nothing to do
 306                                 return 0;
 307                         }
 308                 }
 309
 310                 // We search for the first paragraph with same label
 311                 // that is not more deeply nested.
 312                 Paragraph & prev_par = *prev_it;
 313                 depth_type const prev_depth = getDepth(prev_it);
 314                 if (labeltype == prev_par.layout()->labeltype) {
 315                         if (prev_depth < min_depth) {
 316                                 return prev_par.itemdepth + 1;
 317                         }
 318                         else if (prev_depth == min_depth) {
 319                                 return prev_par.itemdepth;
 320                         }
 321                 }
 322                 min_depth = std::min(min_depth, prev_depth);
 323                 // small optimization: if we are at depth 0, we won't
 324                 // find anything else
 325                 if (prev_depth == 0) {
 326                         return 0;
 327                 }
 328         }
 329 }
 330
 331
 332 bool needEnumCounterReset(ParIterator const & it)
 333 {
 334         Paragraph const & par = *it;
 335         BOOST_ASSERT(par.layout()->labeltype == LABEL_ENUMERATE);
 336         depth_type const cur_depth = par.getDepth();
 337         ParIterator prev_it = it;
 338         while (prev_it.pit()) {
 339                 --prev_it.top().pit();
 340                 Paragraph const & prev_par = *prev_it;
 341                 if (prev_par.getDepth() <= cur_depth)
 342                         return  prev_par.layout()->labeltype != LABEL_ENUMERATE;
 343         }
 344         // start of nested inset: reset
 345         return true;
 346 }
 347
 348
 349 // set the label of a paragraph. This includes the counters.
 350 void setLabel(Buffer const & buf, ParIterator & it)
 351 {
 352         Paragraph & par = *it;
 353         BufferParams const & bufparams = buf.params();
 354         LyXTextClass const & textclass = bufparams.getLyXTextClass();
 355         LyXLayout_ptr const & layout = par.layout();
 356         Counters & counters = textclass.counters();
 357
 358         if (it.pit() == 0) {
 359                 par.params().appendix(par.params().startOfAppendix());
 360         } else {
 361                 par.params().appendix(it.plist()[it.pit() - 1].params().appendix());
 362                 if (!par.params().appendix() &&
 363                     par.params().startOfAppendix()) {
 364                         par.params().appendix(true);
 365                         textclass.counters().reset();
 366                 }
 367         }
 368
 369         // Compute the item depth of the paragraph
 370         par.itemdepth = getItemDepth(it);
 371
 372         // erase what was there before
 373         par.params().labelString(docstring());
 374
 375         if (layout->margintype == MARGIN_MANUAL) {
 376                 if (par.params().labelWidthString().empty())
 377                         par.setLabelWidthString(buf.translateLabel(layout->labelstring()));
 378         } else {
 379                 par.setLabelWidthString(docstring());
 380         }
 381
 382         // is it a layout that has an automatic label?
 383         if (layout->labeltype == LABEL_COUNTER) {
 384                 if (layout->toclevel <= buf.params().secnumdepth
 385                     && (layout->latextype != LATEX_ENVIRONMENT
 386                         || isFirstInSequence(it.pit(), it.plist()))) {
 387                         counters.step(layout->counter);
 388                         docstring label = expandLabel(buf, layout,
 389                                                       par.params().appendix());
 390                         par.params().labelString(label);
 391                 }
 392         } else if (layout->labeltype == LABEL_ITEMIZE) {
 393                 // At some point of time we should do something more
 394                 // clever here, like:
 395                 //   par.params().labelString(
 396                 //    bufparams.user_defined_bullet(par.itemdepth).getText());
 397                 // for now, use a simple hardcoded label
 398                 docstring itemlabel;
 399                 switch (par.itemdepth) {
 400                 case 0:
 401                         itemlabel = char_type(0x2022);
 402                         break;
 403                 case 1:
 404                         itemlabel = char_type(0x2013);
 405                         break;
 406                 case 2:
 407                         itemlabel = char_type(0x2217);
 408                         break;
 409                 case 3:
 410                         itemlabel += char_type(0x2219); // or 0x00b7
 411                         break;
 412                 }
 413
 414                 par.params().labelString(itemlabel);
 415         } else if (layout->labeltype == LABEL_ENUMERATE) {
 416                 // FIXME
 417                 // Yes I know this is a really, really! bad solution
 418                 // (Lgb)
 419                 docstring enumcounter = from_ascii("enum");
 420
 421                 switch (par.itemdepth) {
 422                 case 2:
 423                         enumcounter += 'i';
 424                 case 1:
 425                         enumcounter += 'i';
 426                 case 0:
 427                         enumcounter += 'i';
 428                         break;
 429                 case 3:
 430                         enumcounter += "iv";
 431                         break;
 432                 default:
 433                         // not a valid enumdepth...
 434                         break;
 435                 }
 436
 437                 // Maybe we have to reset the enumeration counter.
 438                 if (needEnumCounterReset(it))
 439                         counters.reset(enumcounter);
 440
 441                 counters.step(enumcounter);
 442
 443                 string format;
 444
 445                 switch (par.itemdepth) {
 446                 case 0:
 447                         format = N_("\\arabic{enumi}.");
 448                         break;
 449                 case 1:
 450                         format = N_("(\\alph{enumii})");
 451                         break;
 452                 case 2:
 453                         format = N_("\\roman{enumiii}.");
 454                         break;
 455                 case 3:
 456                         format = N_("\\Alph{enumiv}.");
 457                         break;
 458                 default:
 459                         // not a valid enumdepth...
 460                         break;
 461                 }
 462
 463                 par.params().labelString(counters.counterLabel(buf.B_(format)));
 464         } else if (layout->labeltype == LABEL_BIBLIO) {// ale970302
 465                 counters.step(from_ascii("bibitem"));
 466                 int number = counters.value(from_ascii("bibitem"));
 467                 if (par.bibitem())
 468                         par.bibitem()->setCounter(number);
 469                 par.params().labelString(buf.translateLabel(layout->labelstring()));
 470                 // In biblio should't be following counters but...
 471         } else if (layout->labeltype == LABEL_SENSITIVE) {
 472                 // Search for the first float or wrap inset in the iterator
 473                 docstring type;
 474                 size_t i = it.depth();
 475                 while (i > 0) {
 476                         --i;
 477                         InsetBase * const in = &it[i].inset();
 478                         if (in->lyxCode() == InsetBase::FLOAT_CODE
 479                             || in->lyxCode() == InsetBase::WRAP_CODE) {
 480                                 type = in->getInsetName();
 481                                 break;
 482                         }
 483                 }
 484
 485                 docstring s;
 486                 if (!type.empty()) {
 487                         Floating const & fl = textclass.floats().getType(to_ascii(type));
 488                         // FIXME UNICODE
 489                         counters.step(from_ascii(fl.type()));
 490
 491                         // Doesn't work... yet.
 492                         s = bformat(_("%1$s #:"), buf.B_(fl.name()));
 493                 } else {
 494                         // par->SetLayout(0);
 495                         s = buf.translateLabel(layout->labelstring());
 496                 }
 497
 498                 par.params().labelString(s);
 499         } else if (layout->labeltype == LABEL_NO_LABEL)
 500                 par.params().labelString(docstring());
 501         else
 502                 par.params().labelString(buf.translateLabel(layout->labelstring()));
 503 }
 504
 505 } // anon namespace
 506
 507
 508 bool updateCurrentLabel(Buffer const & buf,
 509         ParIterator & it)
 510 {
 511     if (it == par_iterator_end(buf.inset()))
 512         return false;
 513
 514 //      if (it.lastpit == 0 && LyXText::isMainText(buf))
 515 //              return false;
 516
 517         switch (it->layout()->labeltype) {
 518
 519         case LABEL_NO_LABEL:
 520         case LABEL_MANUAL:
 521         case LABEL_BIBLIO:
 522         case LABEL_TOP_ENVIRONMENT:
 523         case LABEL_CENTERED_TOP_ENVIRONMENT:
 524         case LABEL_STATIC:
 525         case LABEL_ITEMIZE:
 526                 setLabel(buf, it);
 527                 return true;
 528
 529         case LABEL_SENSITIVE:
 530         case LABEL_COUNTER:
 531         // do more things with enumerate later
 532         case LABEL_ENUMERATE:
 533                 return false;
 534         }
 535
 536         // This is dead code which get rid of a warning:
 537         return true;
 538 }
 539
 540
 541 void updateLabels(Buffer const & buf,
 542         ParIterator & from, ParIterator & to)
 543 {
 544         for (ParIterator it = from; it != to; ++it) {
 545                 if (it.pit() > it.lastpit())
 546                         return;
 547                 if (!updateCurrentLabel (buf, it)) {
 548                         updateLabels(buf);
 549                         return;
 550                 }
 551         }
 552 }
 553
 554
 555 void updateLabels(Buffer const & buf,
 556         ParIterator & iter)
 557 {
 558         if (updateCurrentLabel(buf, iter))
 559                 return;
 560
 561         updateLabels(buf);
 562 }
 563
 564
 565 void updateLabels(Buffer const & buf)
 566 {
 567         // start over the counters
 568         buf.params().getLyXTextClass().counters().reset();
 569
 570         ParIterator const end = par_iterator_end(buf.inset());
 571
 572         for (ParIterator it = par_iterator_begin(buf.inset()); it != end; ++it) {
 573                 // reduce depth if necessary
 574                 if (it.pit()) {
 575                         Paragraph const & prevpar = it.plist()[it.pit() - 1];
 576                         it->params().depth(min(it->params().depth(),
 577                                                prevpar.getMaxDepthAfter()));
 578                 } else
 579                         it->params().depth(0);
 580
 581                 // set the counter for this paragraph
 582                 setLabel(buf, it);
 583         }
 584
 585         const_cast<Buffer &>(buf).tocBackend().update();
 586 }
 587
 588
 589 docstring expandLabel(Buffer const & buf,
 590                       LyXLayout_ptr const & layout, bool appendix)
 591 {
 592         LyXTextClass const & tclass = buf.params().getLyXTextClass();
 593
 594         docstring fmt = buf.translateLabel(appendix ?
 595                         layout->labelstring_appendix() :
 596                         layout->labelstring());
 597
 598         // handle 'inherited level parts' in 'fmt',
 599         // i.e. the stuff between '@' in   '@Section@.\arabic{subsection}'
 600         size_t const i = fmt.find('@', 0);
 601         if (i != docstring::npos) {
 602                 size_t const j = fmt.find('@', i + 1);
 603                 if (j != docstring::npos) {
 604                         docstring parent(fmt, i + 1, j - i - 1);
 605                         // FIXME UNICODE
 606                         docstring label = expandLabel(buf, tclass[to_utf8(parent)], appendix);
 607                         fmt = docstring(fmt, 0, i) + label + docstring(fmt, j + 1, docstring::npos);
 608                 }
 609         }
 610
 611         return tclass.counters().counterLabel(fmt);
 612 }
 613
 614
 615 } // namespace lyx