tags ids 177 | * to their first header tag element to keep references 178 | * in generated markdown 179 | */ 180 | setTitlesId() { 181 | // Pass

id to its first 182 | this.chapters = this.chapters.map((chapter) => { 183 | const $ = cheerio.load(chapter.content); 184 | 185 | $('section').each((i, section) => { 186 | const sectionId = $(section).attr('id'); 187 | //

not found 188 | if (!sectionId) { 189 | return; 190 | } 191 | 192 | // Set

id to first nested header 193 | const $h = $(section).find(':header').first(); 194 | if (!$h.attr('id')) { 195 | $h.attr('id', sectionId); 196 | $(section).removeAttr('id'); 197 | } 198 | }); 199 | 200 | chapter.content = $.html(); 201 | return chapter; 202 | }); 203 | } 204 | } 205 | 206 | /** 207 | * Return all the infos about a title 208 | * from an

TOC element 209 | * 210 | * @param {jQuery Element} $li 211 | * @return {Object} 212 | */ 213 | function extractTOCTitleInfo($li) { 214 | const $span = $li.children('span'); 215 | const $link = $span.children('a'); 216 | 217 | return { 218 | type: $span.attr('class'), 219 | titleId: utils.idFromRef($link.attr('href')), 220 | title: $link.text() 221 | }; 222 | } 223 | 224 | /** 225 | * Return a formatted selector from titleInfo 226 | * 227 | * @param {Object} titleInfo 228 | * @return {String} 229 | */ 230 | function getChapterSelector(titleInfo) { 231 | return `*[id="${titleInfo.titleId}"]`; 232 | } 233 | 234 | /** 235 | * Replace DocBook specific HTML tags 236 | * to be rendered in markdown-compatible HTML 237 | * 238 | * @param {String} html Original HTML 239 | * @return {String} Modified HTML 240 | */ 241 | function processHTML(html) { 242 | const $ = cheerio.load(html); 243 | 244 | // Docbook are converted as

...

245 | // Use

...

instead 246 | $('.literallayout').each((i, el) => { 247 | const $code = $(''); 248 | $code.html($(el).find('p').first().html().trim()); 249 | 250 | const $pre = $('

'); 251 | $code.wrap($pre); 252 | $(el).replaceWith($pre); 253 | }); 254 | 255 | // Convert

 to ...
256 |     $('pre.programlisting, pre.screen').each((i, el) => {
257 |         const $code = $('');
258 |         $code.html($(el).html());
259 |         $(el).html('');
260 |         $(el).append($code);
261 |     });
262 | 
263 |     // Create a  title for  tags
264 |     $('div.example').each((i, el) => {
265 |         // Get id and remove from parent
266 |         const id = $(el).attr('id');
267 |         $(el).removeAttr('id');
268 | 
269 |         // Create  tag with id
270 |         const $h6 = $('
');
271 |         $h6.attr('id', id);
272 | 
273 |         // Replace  tag by 
274 |         const $divTitle = $(el).find('div.example-title');
275 |         $h6.html($divTitle.html());
276 | 
277 |         $divTitle.replaceWith($h6);
278 |     });
279 | 
280 |     // Format footnotes origins
281 |     $('a.footnote, a.footnoteref').each((i, el) => {
282 |         // Check link has only one child
283 |         const $children = $(el).children();
284 |         if (_.size($children) !== 1) {
285 |             return;
286 |         }
287 | 
288 |         // Check that child is a ^{289 |         let $sup = $children.first();
290 |         if (!$sup.is('sup')) {
291 |             return;
292 |         }
293 | 
294 |         // Make ^{parent of 
295 |         $sup.insertBefore($(el));
296 |         // $(el).remove();
297 | 
298 |         $sup = $(el).prev();
299 |         $(el).html($sup.html());
300 | 
301 |         $sup.text('');
302 |         $sup.append($(el));
303 |     });
304 | 
305 |     // Format footnotes
306 |     $('div.footnote').each((i, el) => {
307 |         // Get tags
308 |         const $p   = $(el).find('p').first();
309 |         const $a   = $(el).find('a').first();
310 |         const $sup = $(el).find('sup').first();
311 | 
312 |         // Move  id to ^{313 |         const id = $(el).attr('id');
314 |         $sup.attr('id', id);
315 |         $(el).removeAttr('id');
316 | 
317 |         // Remove} tag
318 |         $a.remove();
319 | 
320 |         // Move ^{at beginning of}
321 |         $sup.html($sup.html() + $p.html());
322 |         $p.html('');
323 |         $p.prepend($sup);
324 | 
325 |         // Move  at the end of ^{tag
326 |         $a.html('↑');
327 |         $sup.append($a);
328 |     });
329 | 
330 |     return $.html();
331 | }
332 | 
333 | module.exports = DocbookConverter;
334 | 


--------------------------------------------------------------------------------
/src/index.js:
--------------------------------------------------------------------------------
 1 | require('babel-polyfill');
 2 | const path = require('path');
 3 | 
 4 | const converters = require('./converters');
 5 | 
 6 | /**
 7 |  * Return the correct converter based on  extension
 8 |  *
 9 |  * @param  {Object}    opts    Program options
10 |  * @return {Converter}
11 |  */
12 | function pickConverter(opts) {
13 |     const ALLOWED_FORMATS = converters.ALLOWED_FORMATS.map(format => format.ext);
14 | 
15 |     const filetype = path.extname(opts.filename).slice(1);
16 |     if (!ALLOWED_FORMATS.includes(filetype)) {
17 |         throw new Error('Unable to convert this file to a GitBook. Accepted formats can be displayed using gitbook-convert -h.');
18 |     }
19 | 
20 |     const Converter = converters[filetype];
21 |     return new Converter(opts);
22 | }
23 | 
24 | module.exports = {
25 |     pickConverter
26 | };
27 | 


--------------------------------------------------------------------------------}}}

${documentTitle}

tag with id 270 | const $h6 = $('