]> git.lyx.org Git - lyx.git/blob - src/insets/insetexternal.C
7c7d888a2c6cdbe0a2b004163446e90cc54328c9
[lyx.git] / src / insets / insetexternal.C
1 /**
2  * \file insetexternal.C
3  * This file is part of LyX, the document processor.
4  * Licence details can be found in the file COPYING.
5  *
6  * \author Asger Alstrup Nielsen
7  *
8  * Full author contact details are available in file CREDITS.
9  */
10
11 #include <config.h>
12
13 #include "insetexternal.h"
14 #include "insets/ExternalSupport.h"
15 #include "insets/ExternalTemplate.h"
16 #include "insets/render_button.h"
17 #include "insets/render_graphic.h"
18 #include "insets/render_preview.h"
19
20 #include "buffer.h"
21 #include "BufferView.h"
22 #include "debug.h"
23 #include "dispatchresult.h"
24 #include "funcrequest.h"
25 #include "gettext.h"
26 #include "LaTeXFeatures.h"
27 #include "lyx_main.h"
28 #include "lyxlex.h"
29 #include "lyxrc.h"
30 #include "metricsinfo.h"
31 #include "outputparams.h"
32
33 #include "frontends/lyx_gui.h"
34 #include "frontends/LyXView.h"
35
36 #include "graphics/PreviewLoader.h"
37
38 #include "support/FileInfo.h"
39 #include "support/filetools.h"
40 #include "support/lstrings.h"
41 #include "support/lyxlib.h"
42 #include "support/tostr.h"
43 #include "support/translator.h"
44
45 #include <boost/bind.hpp>
46
47 #include "support/std_sstream.h"
48
49 namespace support = lyx::support;
50 namespace external = lyx::external;
51 namespace graphics = lyx::graphics;
52
53 using std::endl;
54 using std::string;
55 using std::auto_ptr;
56 using std::istringstream;
57 using std::ostream;
58 using std::ostringstream;
59 using std::vector;
60
61
62 namespace {
63
64 external::DisplayType const defaultDisplayType = external::NoDisplay;
65
66 unsigned int defaultLyxScale = 100;
67
68 } // namespace anon
69
70
71 namespace lyx {
72 namespace external {
73
74 TempName::TempName()
75 {
76         tempname_ = support::tempName(string(), "lyxext");
77         support::unlink(tempname_);
78         // must have an extension for the converter code to work correctly.
79         tempname_ += ".tmp";
80 }
81
82
83 TempName::TempName(TempName const &)
84 {
85         tempname_ = TempName()();
86 }
87
88
89 TempName::~TempName()
90 {
91         support::unlink(tempname_);
92 }
93
94
95 TempName &
96 TempName::operator=(TempName const & other)
97 {
98         if (this != &other)
99                 tempname_ = TempName()();
100         return *this;
101 }
102
103
104 namespace {
105
106 /// The translator between the Display enum and corresponding lyx string.
107 Translator<DisplayType, string> const initTranslator()
108 {
109         Translator<DisplayType, string> translator(DefaultDisplay, "default");
110
111         // Fill the display translator
112         translator.addPair(MonochromeDisplay, "monochrome");
113         translator.addPair(GrayscaleDisplay, "grayscale");
114         translator.addPair(ColorDisplay, "color");
115         translator.addPair(PreviewDisplay, "preview");
116         translator.addPair(NoDisplay, "none");
117
118         return translator;
119 }
120
121 } // namespace anon
122
123
124 Translator<DisplayType, string> const & displayTranslator()
125 {
126         static Translator<DisplayType, string> const translator =
127                 initTranslator();
128         return translator;
129 }
130
131 } // namespace external
132 } // namespace lyx
133
134
135 InsetExternalParams::InsetExternalParams()
136         : display(defaultDisplayType),
137           lyxscale(defaultLyxScale)
138 {}
139
140
141 namespace {
142
143 template <typename T>
144 void clearIfNotFound(T & data, external::TransformID value,
145                      vector<external::TransformID> const & ids)
146 {
147         typedef vector<external::TransformID>::const_iterator
148                 const_iterator;
149
150         const_iterator it  = ids.begin();
151         const_iterator end = ids.end();
152         it = std::find(it, end, value);
153         if (it == end)
154                 data = T();
155 }
156
157 } // namespace anon
158
159
160 void InsetExternalParams::settemplate(string const & name)
161 {
162         templatename_ = name;
163
164         external::TemplateManager const & etm =
165                 external::TemplateManager::get();
166         external::Template const * const et = etm.getTemplateByName(name);
167         if (!et)
168                 // Be safe. Don't lose data.
169                 return;
170
171         // Ascertain which transforms the template supports.
172         // Empty all those that it doesn't.
173         vector<external::TransformID> const & ids = et->transformIds;
174         clearIfNotFound(clipdata,     external::Clip,   ids);
175         clearIfNotFound(extradata,    external::Extra,  ids);
176         clearIfNotFound(resizedata,   external::Resize, ids);
177         clearIfNotFound(rotationdata, external::Rotate, ids);
178 }
179
180
181 void InsetExternalParams::write(Buffer const & buffer, ostream & os) const
182 {
183         os << "External\n"
184            << "\ttemplate " << templatename() << '\n';
185
186         if (!filename.empty())
187                 os << "\tfilename "
188                    << filename.outputFilename(buffer.filePath())
189                    << '\n';
190
191         if (display != defaultDisplayType)
192                 os << "\tdisplay "
193                    << external::displayTranslator().find(display)
194                    << '\n';
195
196         if (lyxscale != defaultLyxScale)
197                 os << "\tlyxscale " << tostr(lyxscale) << '\n';
198
199         if (!clipdata.bbox.empty())
200                 os << "\tboundingBox " << clipdata.bbox << '\n';
201         if (clipdata.clip)
202                 os << "\tclip\n";
203
204         external::ExtraData::const_iterator it  = extradata.begin();
205         external::ExtraData::const_iterator end = extradata.end();
206         for (; it != end; ++it) {
207                 if (!it->second.empty())
208                         os << "\textra " << it->first << " \""
209                            << it->second << "\"\n";
210         }
211
212         if (!rotationdata.no_rotation()) {
213                 os << "\trotateAngle " << rotationdata.angle() << '\n';
214                 if (rotationdata.origin() != external::RotationData::DEFAULT)
215                         os << "\trotateOrigin "
216                            << rotationdata.originString() << '\n';
217         }
218
219         if (!resizedata.no_resize()) {
220                 using support::float_equal;
221
222                 if (!float_equal(resizedata.scale, 0.0, 0.05)) {
223                         if (!float_equal(resizedata.scale, 100.0, 0.05))
224                                 os << "\tscale "
225                                    << resizedata.scale << '\n';
226                 } else {
227                         if (!resizedata.width.zero())
228                                 os << "\twidth "
229                                    << resizedata.width.asString() << '\n';
230                         if (!resizedata.height.zero())
231                                 os << "\theight "
232                                    << resizedata.height.asString() << '\n';
233                 }
234                 if (resizedata.keepAspectRatio)
235                         os << "\tkeepAspectRatio\n";
236         }
237 }
238
239
240 bool InsetExternalParams::read(Buffer const & buffer, LyXLex & lex)
241 {
242         enum ExternalTags {
243                 EX_TEMPLATE = 1,
244                 EX_FILENAME,
245                 EX_DISPLAY,
246                 EX_LYXSCALE,
247                 EX_BOUNDINGBOX,
248                 EX_CLIP,
249                 EX_EXTRA,
250                 EX_HEIGHT,
251                 EX_KEEPASPECTRATIO,
252                 EX_ROTATEANGLE,
253                 EX_ROTATEORIGIN,
254                 EX_SCALE,
255                 EX_WIDTH,
256                 EX_END
257         };
258
259         keyword_item external_tags[] = {
260                 { "\\end_inset",     EX_END },
261                 { "boundingBox",     EX_BOUNDINGBOX },
262                 { "clip",            EX_CLIP },
263                 { "display",         EX_DISPLAY},
264                 { "extra",           EX_EXTRA },
265                 { "filename",        EX_FILENAME},
266                 { "height",          EX_HEIGHT },
267                 { "keepAspectRatio", EX_KEEPASPECTRATIO },
268                 { "lyxscale",        EX_LYXSCALE},
269                 { "rotateAngle",     EX_ROTATEANGLE },
270                 { "rotateOrigin",    EX_ROTATEORIGIN },
271                 { "scale",           EX_SCALE },
272                 { "template",        EX_TEMPLATE },
273                 { "width",           EX_WIDTH }
274         };
275
276         pushpophelper pph(lex, external_tags, EX_END);
277
278         bool found_end  = false;
279         bool read_error = false;
280
281         while (lex.isOK()) {
282                 switch (lex.lex()) {
283                 case EX_TEMPLATE:
284                         lex.next();
285                         templatename_ = lex.getString();
286                         break;
287
288                 case EX_FILENAME: {
289                         lex.next();
290                         string const name = lex.getString();
291                         filename.set(name, buffer.filePath());
292                         break;
293                 }
294
295                 case EX_DISPLAY: {
296                         lex.next();
297                         string const name = lex.getString();
298                         display = external::displayTranslator().find(name);
299                         break;
300                 }
301
302                 case EX_LYXSCALE:
303                         lex.next();
304                         lyxscale = lex.getInteger();
305                         break;
306
307                 case EX_BOUNDINGBOX:
308                         lex.next();
309                         clipdata.bbox.xl = lex.getInteger();
310                         lex.next();
311                         clipdata.bbox.yb = lex.getInteger();
312                         lex.next();
313                         clipdata.bbox.xr = lex.getInteger();
314                         lex.next();
315                         clipdata.bbox.yt = lex.getInteger();
316                         break;
317
318                 case EX_CLIP:
319                         clipdata.clip = true;
320                         break;
321
322                 case EX_EXTRA: {
323                         lex.next();
324                         string const name = lex.getString();
325                         lex.next();
326                         extradata.set(name, lex.getString());
327                         break;
328                 }
329
330                 case EX_HEIGHT:
331                         lex.next();
332                         resizedata.height = LyXLength(lex.getString());
333                         break;
334
335                 case EX_KEEPASPECTRATIO:
336                         resizedata.keepAspectRatio = true;
337                         break;
338
339                 case EX_ROTATEANGLE:
340                         lex.next();
341                         rotationdata.angle(lex.getFloat());
342                         break;
343
344                 case EX_ROTATEORIGIN:
345                         lex.next();
346                         rotationdata.origin(lex.getString());
347                         break;
348
349                 case EX_SCALE:
350                         lex.next();
351                         resizedata.scale = lex.getFloat();
352                         break;
353
354                 case EX_WIDTH:
355                         lex.next();
356                         resizedata.width = LyXLength(lex.getString());
357                         break;
358
359                 case EX_END:
360                         found_end = true;
361                         break;
362
363                 default:
364                         lex.printError("ExternalInset::read: "
365                                        "Wrong tag: $$Token");
366                         read_error = true;
367                         break;
368                 }
369
370                 if (found_end || read_error)
371                         break;
372         }
373
374         if (!found_end)
375                 lex.printError("ExternalInset::read: Missing \\end_inset.");
376
377         // This is a trick to make sure that the data are self-consistent.
378         settemplate(templatename_);
379
380         if (lyxerr.debugging(Debug::EXTERNAL)) {
381                 lyxerr  << "InsetExternalParams::read:\n";
382                 write(buffer, lyxerr);
383         }
384
385         return !read_error;
386 }
387
388
389 InsetExternal::InsetExternal()
390         : renderer_(new RenderButton)
391 {}
392
393
394 InsetExternal::InsetExternal(InsetExternal const & other)
395         : InsetOld(other),
396           boost::signals::trackable(),
397           params_(other.params_),
398           renderer_(other.renderer_->clone())
399 {
400         if (renderer_->asMonitoredPreview() != 0) {
401                 RenderMonitoredPreview * const ptr = renderer_->asMonitoredPreview();
402                 ptr->connect(boost::bind(&InsetExternal::statusChanged, this));
403                 ptr->fileChanged(boost::bind(&InsetExternal::fileChanged, this));
404
405         } else if (renderer_->asGraphic() != 0 ) {
406                 RenderGraphic * const ptr = renderer_->asGraphic();
407                 ptr->connect(boost::bind(&InsetExternal::statusChanged, this));
408         }
409 }
410
411
412 auto_ptr<InsetBase> InsetExternal::clone() const
413 {
414         return auto_ptr<InsetBase>(new InsetExternal(*this));
415 }
416
417
418 InsetExternal::~InsetExternal()
419 {
420         InsetExternalMailer(*this).hideDialog();
421 }
422
423
424 void InsetExternal::statusChanged() const
425 {
426         LyX::cref().updateInset(this);
427 }
428
429
430 DispatchResult
431 InsetExternal::priv_dispatch(FuncRequest const & cmd, idx_type &, pos_type &)
432 {
433         switch (cmd.action) {
434
435         case LFUN_EXTERNAL_EDIT: {
436                 BOOST_ASSERT(cmd.view());
437
438                 Buffer const & buffer = *cmd.view()->buffer();
439                 InsetExternalParams p;
440                 InsetExternalMailer::string2params(cmd.argument, buffer, p);
441                 external::editExternal(p, buffer);
442                 return DispatchResult(true);
443         }
444
445         case LFUN_INSET_MODIFY: {
446                 BOOST_ASSERT(cmd.view());
447
448                 Buffer const & buffer = *cmd.view()->buffer();
449                 InsetExternalParams p;
450                 InsetExternalMailer::string2params(cmd.argument, buffer, p);
451                 setParams(p, buffer);
452                 cmd.view()->update();
453                 return DispatchResult(true, true);
454         }
455
456         case LFUN_INSET_DIALOG_UPDATE:
457                 InsetExternalMailer(*this).updateDialog(cmd.view());
458                 return DispatchResult(true, true);
459
460         case LFUN_MOUSE_RELEASE:
461                 InsetExternalMailer(*this).showDialog(cmd.view());
462                 return DispatchResult(true, true);
463
464         default:
465                 return DispatchResult(false);
466         }
467 }
468
469
470 void InsetExternal::edit(BufferView * bv, bool)
471 {
472         InsetExternalMailer(*this).showDialog(bv);
473 }
474
475
476 void InsetExternal::metrics(MetricsInfo & mi, Dimension & dim) const
477 {
478         renderer_->metrics(mi, dim);
479         dim_ = dim;
480 }
481
482
483 void InsetExternal::draw(PainterInfo & pi, int x, int y) const
484 {
485         xo_ = x;
486         yo_ = y;
487         renderer_->draw(pi, x, y);
488 }
489
490
491 namespace {
492
493 enum RenderType {
494         RENDERBUTTON,
495         RENDERGRAPHIC,
496         RENDERPREVIEW
497 };
498
499
500 RenderType getRenderType(InsetExternalParams const & p)
501 {
502         if (!external::getTemplatePtr(p) ||
503             p.filename.empty() ||
504             p.display == external::NoDisplay)
505                 return RENDERBUTTON;
506
507         if (p.display == external::PreviewDisplay) {
508                 if (RenderPreview::activated())
509                         return RENDERPREVIEW;
510                 return RENDERBUTTON;
511         }
512
513         if (p.display == external::DefaultDisplay &&
514             lyxrc.display_graphics == graphics::NoDisplay)
515                 return RENDERBUTTON;
516         return RENDERGRAPHIC;
517 }
518
519
520 graphics::Params get_grfx_params(InsetExternalParams const & eparams)
521 {
522         graphics::Params gparams;
523
524         gparams.filename = eparams.filename.absFilename();
525         gparams.scale = eparams.lyxscale;
526         if (eparams.clipdata.clip)
527                 gparams.bb = eparams.clipdata.bbox;
528         gparams.angle = eparams.rotationdata.angle();
529
530         switch (eparams.display) {
531         case external::DefaultDisplay:
532                 gparams.display = graphics::DefaultDisplay;
533                 break;
534         case external::MonochromeDisplay:
535                 gparams.display = graphics::MonochromeDisplay;
536                 break;
537         case external::GrayscaleDisplay:
538                 gparams.display = graphics::GrayscaleDisplay;
539                 break;
540         case external::ColorDisplay:
541                 gparams.display = graphics::ColorDisplay;
542                 break;
543         case external::NoDisplay:
544                 gparams.display = graphics::NoDisplay;
545                 break;
546         default:
547                 BOOST_ASSERT(false);
548         }
549         if (gparams.display == graphics::DefaultDisplay)
550                 gparams.display = lyxrc.display_graphics;
551         // Override the above if we're not using a gui
552         if (!lyx_gui::use_gui)
553                 gparams.display = graphics::NoDisplay;
554
555         return gparams;
556 }
557
558
559 string const getScreenLabel(InsetExternalParams const & params,
560                             Buffer const & buffer)
561 {
562         external::Template const * const ptr =
563                 external::getTemplatePtr(params);
564         if (!ptr)
565                 return support::bformat(_("External template %1$s is not installed"),
566                                         params.templatename());
567         return external::doSubstitution(params, buffer, ptr->guiName);
568 }
569
570 void add_preview(RenderMonitoredPreview &, InsetExternal const &, Buffer const &);
571
572 } // namespace anon
573
574
575 InsetExternalParams const & InsetExternal::params() const
576 {
577         return params_;
578 }
579
580
581 void InsetExternal::setParams(InsetExternalParams const & p,
582                               Buffer const & buffer)
583 {
584         params_ = p;
585
586         switch (getRenderType(params_)) {
587         case RENDERBUTTON: {
588                 RenderButton * button_ptr = renderer_->asButton();
589                 if (!button_ptr) {
590                         renderer_.reset(new RenderButton);
591                         button_ptr = renderer_->asButton();
592                 }
593
594                 button_ptr->update(getScreenLabel(params_, buffer), true);
595                 break;
596
597         } case RENDERGRAPHIC: {
598                 RenderGraphic * graphic_ptr = renderer_->asGraphic();
599                 if (!graphic_ptr) {
600                         renderer_.reset(new RenderGraphic);
601                         graphic_ptr = renderer_->asGraphic();
602                         graphic_ptr->connect(
603                                 boost::bind(&InsetExternal::statusChanged, this));
604                 }
605
606                 graphic_ptr->update(get_grfx_params(params_));
607
608                 break;
609
610         } case RENDERPREVIEW: {
611                 RenderMonitoredPreview * preview_ptr =
612                         renderer_->asMonitoredPreview();
613                 if (!preview_ptr) {
614                         renderer_.reset(new RenderMonitoredPreview);
615                         preview_ptr = renderer_->asMonitoredPreview();
616                         preview_ptr->connect(
617                                 boost::bind(&InsetExternal::statusChanged, this));
618                         preview_ptr->fileChanged(
619                                 boost::bind(&InsetExternal::fileChanged, this));
620                 }
621
622                 if (preview_ptr->monitoring())
623                         preview_ptr->stopMonitoring();
624                 add_preview(*preview_ptr, *this, buffer);
625
626                 break;
627         }
628         }
629 }
630
631
632 void InsetExternal::fileChanged() const
633 {
634         Buffer const * const buffer_ptr = LyX::cref().updateInset(this);
635         if (!buffer_ptr)
636                 return;
637
638         RenderMonitoredPreview * const ptr = renderer_->asMonitoredPreview();
639         BOOST_ASSERT(ptr);
640
641         Buffer const & buffer = *buffer_ptr;
642         ptr->removePreview(buffer);
643         add_preview(*ptr, *this, buffer);
644         ptr->startLoading(buffer);
645 }
646
647
648 void InsetExternal::write(Buffer const & buffer, ostream & os) const
649 {
650         params_.write(buffer, os);
651 }
652
653
654 void InsetExternal::read(Buffer const & buffer, LyXLex & lex)
655 {
656         InsetExternalParams params;
657         if (params.read(buffer, lex))
658                 setParams(params, buffer);
659 }
660
661
662 int InsetExternal::latex(Buffer const & buf, ostream & os,
663                          OutputParams const & runparams) const
664 {
665         // "nice" means that the buffer is exported to LaTeX format but not
666         // run through the LaTeX compiler.
667         // If we're running through the LaTeX compiler, we should write the
668         // generated files in the bufer's temporary directory.
669         bool const external_in_tmpdir =
670                 lyxrc.use_tempdir && !buf.temppath().empty() && !runparams.nice;
671
672         // If the template has specified a PDFLaTeX output, then we try and
673         // use that.
674         if (runparams.flavor == OutputParams::PDFLATEX) {
675                 external::Template const * const et_ptr =
676                         external::getTemplatePtr(params_);
677                 if (!et_ptr)
678                         return 0;
679                 external::Template const & et = *et_ptr;
680
681                 external::Template::Formats::const_iterator cit =
682                         et.formats.find("PDFLaTeX");
683                 if (cit != et.formats.end())
684                         return external::writeExternal(params_, "PDFLaTeX",
685                                              buf, os, external_in_tmpdir);
686         }
687
688         return external::writeExternal(params_, "LaTeX",
689                                        buf, os, external_in_tmpdir);
690 }
691
692
693 int InsetExternal::plaintext(Buffer const & buf, ostream & os,
694                          OutputParams const &) const
695 {
696         return external::writeExternal(params_, "Ascii", buf, os);
697 }
698
699
700 int InsetExternal::linuxdoc(Buffer const & buf, ostream & os,
701                             OutputParams const &) const
702 {
703         return external::writeExternal(params_, "LinuxDoc", buf, os);
704 }
705
706
707 int InsetExternal::docbook(Buffer const & buf, ostream & os,
708                            OutputParams const &) const
709 {
710         return external::writeExternal(params_, "DocBook", buf, os);
711 }
712
713
714 void InsetExternal::validate(LaTeXFeatures & features) const
715 {
716         external::Template const * const et_ptr =
717                 external::getTemplatePtr(params_);
718         if (!et_ptr)
719                 return;
720         external::Template const & et = *et_ptr;
721
722         external::Template::Formats::const_iterator cit =
723                 et.formats.find("LaTeX");
724         if (cit == et.formats.end())
725                 return;
726
727         if (!cit->second.requirement.empty())
728                 features.require(cit->second.requirement);
729
730         external::TemplateManager & etm = external::TemplateManager::get();
731
732         vector<string>::const_iterator it  = cit->second.preambleNames.begin();
733         vector<string>::const_iterator end = cit->second.preambleNames.end();
734         for (; it != end; ++it) {
735                 string const preamble = etm.getPreambleDefByName(*it);
736                 if (!preamble.empty())
737                         features.addExternalPreamble(preamble);
738         }
739 }
740
741
742 //
743 // preview stuff
744 //
745
746 namespace {
747
748 bool preview_wanted(InsetExternalParams const & params)
749 {
750         string const included_file = params.filename.absFilename();
751
752         return params.display == external::PreviewDisplay &&
753                 support::IsFileReadable(included_file);
754 }
755
756
757 string const latex_string(InsetExternal const & inset, Buffer const & buffer)
758 {
759         ostringstream os;
760         OutputParams runparams;
761         runparams.flavor = OutputParams::LATEX;
762         inset.latex(buffer, os, runparams);
763
764         return os.str();
765 }
766
767
768 void add_preview(RenderMonitoredPreview & renderer, InsetExternal const & inset,
769                  Buffer const & buffer)
770 {
771         InsetExternalParams const & params = inset.params();
772         if (RenderPreview::activated() && preview_wanted(params)) {
773                 renderer.setAbsFile(params.filename.absFilename());
774                 string const snippet = latex_string(inset, buffer);
775                 renderer.addPreview(snippet, buffer);
776         }
777 }
778
779 } // namespace anon
780
781
782 void InsetExternal::addPreview(graphics::PreviewLoader & ploader) const
783 {
784         RenderMonitoredPreview * const ptr = renderer_->asMonitoredPreview();
785         if (!ptr)
786                 return;
787
788         if (preview_wanted(params())) {
789                 ptr->setAbsFile(params_.filename.absFilename());
790                 string const snippet = latex_string(*this, ploader.buffer());
791                 ptr->addPreview(snippet, ploader);
792         }
793 }
794
795
796 /// Mailer stuff
797
798 string const InsetExternalMailer::name_("external");
799
800 InsetExternalMailer::InsetExternalMailer(InsetExternal & inset)
801         : inset_(inset)
802 {}
803
804
805 string const InsetExternalMailer::inset2string(Buffer const & buffer) const
806 {
807         return params2string(inset_.params(), buffer);
808 }
809
810
811 void InsetExternalMailer::string2params(string const & in,
812                                         Buffer const & buffer,
813                                         InsetExternalParams & params)
814 {
815         params = InsetExternalParams();
816
817         if (in.empty())
818                 return;
819
820         istringstream data(in);
821         LyXLex lex(0,0);
822         lex.setStream(data);
823
824         if (lex.isOK()) {
825                 lex.next();
826                 string const token = lex.getString();
827                 if (token != name_)
828                         return;
829         }
830
831         // This is part of the inset proper that is usually swallowed
832         // by Buffer::readInset
833         if (lex.isOK()) {
834                 lex.next();
835                 string const token = lex.getString();
836                 if (token != "External")
837                         return;
838         }
839
840         if (lex.isOK()) {
841                 params.read(buffer, lex);
842         }
843 }
844
845
846 string const
847 InsetExternalMailer::params2string(InsetExternalParams const & params,
848                                    Buffer const & buffer)
849 {
850         ostringstream data;
851         data << name_ << ' ';
852         params.write(buffer, data);
853         data << "\\end_inset\n";
854         return data.str();
855 }