]> git.lyx.org Git - lyx.git/blob - src/LayoutFile.cpp
Add doxy.
[lyx.git] / src / LayoutFile.cpp
1 /**
2  * \file LayoutFileList.cpp
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 John Levon
8  *
9  * Full author contact details are available in file CREDITS.
10  */
11
12 #include <config.h>
13
14 #include "LayoutFile.h"
15 #include "Counters.h"
16 #include "Floating.h"
17 #include "FloatList.h"
18 #include "Lexer.h"
19 #include "TextClass.h"
20
21 #include "support/debug.h"
22 #include "support/FileName.h"
23 #include "support/filetools.h"
24 #include "support/gettext.h"
25
26 #include <boost/bind.hpp>
27 #include <boost/regex.hpp>
28
29 #include <fstream>
30
31 using namespace std;
32 using namespace lyx::support;
33
34 namespace lyx {
35
36 using boost::bind;
37 using boost::regex;
38 using boost::smatch;
39
40 LayoutFile::LayoutFile(string const & fn, string const & cln,
41                            string const & desc, bool texClassAvail )
42 {
43         name_ = fn;
44         latexname_ = cln;
45         description_ = desc;
46         texClassAvail_ = texClassAvail;
47 }
48
49
50 LayoutFileList & LayoutFileList::get() 
51 {
52         static LayoutFileList baseclasslist;
53         return baseclasslist;
54 }
55
56
57 bool LayoutFileList::haveClass(string const & classname) const
58 {
59         ClassMap::const_iterator it = classmap_.begin();
60         ClassMap::const_iterator en = classmap_.end();
61         for (; it != en; ++it) {
62                 if (it->first == classname)
63                         return true;
64         }
65         return false;
66 }
67
68
69 LayoutFile const & LayoutFileList::operator[](string const & classname) const
70 {
71         BOOST_ASSERT(haveClass(classname));
72         return *classmap_[classname];
73 }
74
75
76 LayoutFile & 
77         LayoutFileList::operator[](string const & classname)
78 {
79         BOOST_ASSERT(haveClass(classname));
80         return *classmap_[classname];
81 }
82
83
84 // Reads LyX textclass definitions according to textclass config file
85 bool LayoutFileList::read()
86 {
87         Lexer lex(0, 0);
88         FileName const real_file = libFileSearch("", "textclass.lst");
89         LYXERR(Debug::TCLASS, "Reading textclasses from `" << real_file << '\'');
90
91         if (real_file.empty()) {
92                 lyxerr << "LayoutFileList::Read: unable to find "
93                           "textclass file  `"
94                        << to_utf8(makeDisplayPath(real_file.absFilename(), 1000))
95                        << "'. Exiting." << endl;
96                 return false;
97                 // This causes LyX to end... Not a desirable behaviour. Lgb
98                 // What do you propose? That the user gets a file dialog
99                 // and is allowed to hunt for the file? (Asger)
100                 // more that we have a layout for minimal.cls statically
101                 // compiled in... (Lgb)
102         }
103
104         if (!lex.setFile(real_file)) {
105                 lyxerr << "LayoutFileList::Read: "
106                         "lyxlex was not able to set file: "
107                        << real_file << endl;
108         }
109
110         if (!lex.isOK()) {
111                 lyxerr << "LayoutFileList::Read: unable to open "
112                           "textclass file  `"
113                        << to_utf8(makeDisplayPath(real_file.absFilename(), 1000))
114                        << "'\nCheck your installation. LyX can't continue."
115                        << endl;
116                 return false;
117         }
118
119         bool finished = false;
120         // Parse config-file
121         LYXERR(Debug::TCLASS, "Starting parsing of textclass.lst");
122         while (lex.isOK() && !finished) {
123                 LYXERR(Debug::TCLASS, "\tline by line");
124                 switch (lex.lex()) {
125                 case Lexer::LEX_FEOF:
126                         finished = true;
127                         break;
128                 default:
129                         string const fname = lex.getString();
130                         LYXERR(Debug::TCLASS, "Fname: " << fname);
131                         if (lex.next()) {
132                                 string const clname = lex.getString();
133                                 LYXERR(Debug::TCLASS, "Clname: " << clname);
134                                 if (lex.next()) {
135                                         string const desc = lex.getString();
136                                         LYXERR(Debug::TCLASS, "Desc: " << desc);
137                                         if (lex.next()) {
138                                                 bool avail = lex.getBool();
139                                                 LYXERR(Debug::TCLASS, "Avail: " << avail);
140                                                 // This code is run when we have
141                                                 // fname, clname, desc, and avail
142                                                 LayoutFile * tmpl = new LayoutFile(fname, clname, desc, avail);
143                                                 if (lyxerr.debugging(Debug::TCLASS)) {
144                                                         // only system layout files are loaded here so no
145                                                         // buffer path is needed.
146                                                         tmpl->load();
147                                                 }
148                                                 classmap_[fname] = tmpl;
149                                         }
150                                 }
151                         }
152                 }
153         }
154         LYXERR(Debug::TCLASS, "End of parsing of textclass.lst");
155
156         // lyx will start with an empty classmap_, but only reconfigure is allowed
157         // in this case. This gives users a second chance to configure lyx if
158         // initial configuration fails. (c.f. bug 2829)
159         if (classmap_.empty())
160                 lyxerr << "LayoutFileList::Read: no textclasses found!"
161                        << endl;
162         return true;
163 }
164
165
166 std::vector<LayoutFileIndex> LayoutFileList::classList() const
167 {
168         std::vector<LayoutFileIndex> cl;
169         ClassMap::const_iterator it = classmap_.begin();
170         ClassMap::const_iterator en = classmap_.end();
171         for (; it != en; ++it)
172                 cl.push_back(it->first);
173         return cl;
174 }
175
176
177 void LayoutFileList::reset(LayoutFileIndex const & classname) {
178         BOOST_ASSERT(haveClass(classname));
179         LayoutFile * tc = classmap_[classname];
180         LayoutFile * tmpl = 
181                 new LayoutFile(tc->name(), tc->latexname(), tc->description(),
182                                tc->isTeXClassAvailable());
183         classmap_[classname] = tmpl;
184         delete tc;
185 }
186
187
188 string const LayoutFileList::localPrefix = "LOCAL:";
189 string const LayoutFileList::embeddedPrefix = "EMBED:";
190
191
192 LayoutFileIndex 
193         LayoutFileList::addLayoutFile(string const & textclass, string const & path,
194                 Layout_Type type)
195 {
196         // FIXME  There is a bug here: 4593
197         //
198         // only check for textclass.layout file, .cls can be anywhere in $TEXINPUTS
199         // NOTE: latex class name is defined in textclass.layout, which can be 
200         // different from textclass
201         string fullName = addName(path, textclass + ".layout");
202         string localIndex;
203         
204         if (type == Local)
205                 localIndex = localPrefix + fullName;
206         else if (type == Embedded)
207                 localIndex = embeddedPrefix + textclass;
208         
209         // if the local file has already been loaded, return it
210         if (haveClass(localIndex))
211                 return localIndex;
212
213         FileName const layout_file(fullName);
214         if (layout_file.exists()) {
215                 LYXERR(Debug::TCLASS, "Adding class " << textclass << " from directory " << path);
216                 // Read .layout file and get description, real latex classname etc
217                 //
218                 // This is a C++ version of function processLayoutFile in configure.py,
219                 // which uses the following regex
220                 //     \Declare(LaTeX|DocBook)Class\s*(\[([^,]*)(,.*)*\])*\s*{(.*)}
221                 ifstream ifs(layout_file.toFilesystemEncoding().c_str());
222                 static regex const reg("^#\\s*\\\\Declare(LaTeX|DocBook)Class\\s*"
223                         "(?:\\[([^,]*)(?:,.*)*\\])*\\s*\\{(.*)\\}\\s*");
224                 string line;
225                 while (getline(ifs, line)) {
226                         // look for the \DeclareXXXClass line
227                         smatch sub;
228                         if (regex_match(line, sub, reg)) {
229                                 // returns: whole string, classtype (not used here), class name, description
230                                 BOOST_ASSERT(sub.size() == 4);
231                                 // now, create a TextClass with description containing path information
232                                 string className(sub.str(2) == "" ? textclass : sub.str(2));
233                                 LayoutFile * tmpl = 
234                                         new LayoutFile(textclass, className, localIndex, true);
235                                 // This textclass is added on request so it will definitely be
236                                 // used. Load it now because other load() calls may fail if they
237                                 // are called in a context without buffer path information.
238                                 tmpl->load(path);
239                                 classmap_[localIndex] = tmpl;
240                                 return localIndex;
241                         }
242                 }
243         }
244         // If .layout is not in local directory, or an invalid layout is found, return null
245         return string();
246 }
247
248
249 LayoutFileIndex defaultBaseclass()
250 {
251         if (LayoutFileList::get().haveClass("article"))
252                 return string("article");
253         if (LayoutFileList::get().empty())
254                 return string();
255         return LayoutFileList::get().classList().front();
256 }
257
258
259
260 // Reads the style files
261 bool LyXSetStyle()
262 {
263         LYXERR(Debug::TCLASS, "LyXSetStyle: parsing configuration...");
264
265         if (!LayoutFileList::get().read()) {
266                 LYXERR(Debug::TCLASS, "LyXSetStyle: an error occured "
267                         "during parsing.\n             Exiting.");
268                 return false;
269         }
270
271         LYXERR(Debug::TCLASS, "LyXSetStyle: configuration parsed.");
272         return true;
273 }
274
275
276 } // namespace lyx