aboutsummaryrefslogtreecommitdiff
path: root/doc/user/infoe.skb
blob: d11e0b6dff53c9582ef030f1e668827941c40d3b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
;;; info.skb  --  Documentation of the Info engine.
;;; -*- coding: iso-8859-1 -*-
;;;
;;; Copyright 2009, 2012  Ludovic Court�s <ludo@gnu.org>
;;;
;;;
;;; This file is part of Skribilo.
;;;
;;; Skribilo is free software: you can redistribute it and/or modify
;;; it under the terms of the GNU General Public License as published by
;;; the Free Software Foundation, either version 3 of the License, or
;;; (at your option) any later version.
;;;
;;; Skribilo is distributed in the hope that it will be useful,
;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with Skribilo.  If not, see <http://www.gnu.org/licenses/>.

(section :title "Info Engine" :file #t :ident "info-engine"
   (index "Info" :note "Engine")

   (p [The ,(tt [info]) engine produces GNU,(~)Info files for on-line
browsing with GNU,(~)Emacs or with the stand-alone Info reader of ,(ref
:text [GNU,(~)Texinfo] :url "http://www.gnu.org/software/texinfo/").])
   
   (p [For each ,(markup-ref "chapter"), ,(markup-ref "section"), etc.,
an Info node is created, whose name is inferred from the ,(param :title)
option.  However, Info node names have to be unique, which the ,(param
:title) options are not necessarily.  Thus, the Info engine does two
things:

,(enumerate
    (item [It warns you about duplicate Info node titles.])
    (item [It allows you to choose a different node name to avoid
conflicts, using the ,(param :info-node) option of ,(markup-ref
"chapter"), etc.]))

Most markups shown in ,(numref :text [Chapter] :ident "std-markups") are
meaningfully rendered in Info, including tables.  However, since Info is
a text-only format, markups such as ,(markup-ref "image") do not yield a
graphical output as with other engines.]))

;;; Local Variables:
;;; ispell-local-dictionary: "american"
;;; End: