|
1 |
# configuration file for generation of html-docu from m-files
|
|
2 |
#
|
|
3 |
# Author: Hartmut Pohlheim
|
|
4 |
# History: 05.11.2000 file created (parameters for mtree2html2001)
|
|
5 |
#
|
|
6 |
# The following options/variables must be changed/adapted:
|
|
7 |
# dirmfiles
|
|
8 |
# dirhtml
|
|
9 |
# csslink
|
|
10 |
# texttitleframelayout
|
|
11 |
# texttitlefiles
|
|
12 |
#
|
|
13 |
# The following options/variables should be adapted:
|
|
14 |
# authorfile
|
|
15 |
# filenametopframe
|
|
16 |
# codeheadmeta
|
|
17 |
|
|
18 |
#========================================================================
|
|
19 |
# Variables (possible keywords: set)
|
|
20 |
# to use the built-in settings, comment the line using # in first column
|
|
21 |
#========================================================================
|
|
22 |
|
|
23 |
#------------------------------------------------------------------------
|
|
24 |
# dirmfiles: name of directory containing Matlab m-files
|
|
25 |
# dirhtml: name of directory to place the html-files into
|
|
26 |
# exthtml: extension used for the html files (.html or .htm)
|
|
27 |
# don't forget the point in front of the extension
|
|
28 |
#------------------------------------------------------------------------
|
|
29 |
set dirmfiles = .
|
|
30 |
set dirhtml = doc-output
|
|
31 |
set exthtml = .html
|
|
32 |
|
|
33 |
#------------------------------------------------------------------------
|
|
34 |
# authorfile: name of file containing info about author (in html)
|
|
35 |
# if defined, this text is included at the bottom of the
|
|
36 |
# html files
|
|
37 |
#------------------------------------------------------------------------
|
|
38 |
set authorfile = /work/soundsoftware-site/extra/soundsoftware/matlab-docs-credit.html
|
|
39 |
|
|
40 |
#------------------------------------------------------------------------
|
|
41 |
# csslink: text for linking to css file (style sheets)
|
|
42 |
# the text defined here is directly included into the head
|
|
43 |
# of the html file
|
|
44 |
#------------------------------------------------------------------------
|
|
45 |
set csslink = <link rel=stylesheet type="text/css" href="CSSFILENAME.css" />
|
|
46 |
|
|
47 |
#------------------------------------------------------------------------
|
|
48 |
# links2filescase: this is a bit difficult
|
|
49 |
# Matlab is case sensitive on UNIX, but case insensitive
|
|
50 |
# on Windows. Under UNIX Matlab function calls work
|
|
51 |
# only, when the case of file name and function call are
|
|
52 |
# identical, under Windows you can do what you want.
|
|
53 |
# This scripts help you, to keep an exact case in your
|
|
54 |
# project.
|
|
55 |
# exact - internal links are only generated, when case of file
|
|
56 |
# name and in source code are identical
|
|
57 |
# all - case doesn't matter
|
|
58 |
# exactupper - same as exact, additionally links are also vreated to
|
|
59 |
# all upper case function names in source code (often
|
|
60 |
# used by Mathworks)
|
|
61 |
# exactvery - same as exact, additionally info about not matching
|
|
62 |
# case is written to screen (stdout), this can be very
|
|
63 |
# helpful in cleaning up the case in a project
|
|
64 |
#------------------------------------------------------------------------
|
|
65 |
set links2filescase = all
|
|
66 |
|
|
67 |
#------------------------------------------------------------------------
|
|
68 |
# texttitleframelayout: text of title for frame layout file (whole docu)
|
|
69 |
#------------------------------------------------------------------------
|
|
70 |
set texttitleframelayout = Documentation of Matlab Functions of PROJEKTNAME
|
|
71 |
|
|
72 |
#------------------------------------------------------------------------
|
|
73 |
# texttitle/headerindexalldirs: text of title and header for directory index
|
|
74 |
#------------------------------------------------------------------------
|
|
75 |
set texttitleindexalldirs = Index of Directories
|
|
76 |
set textheaderindexalldirs = Index of Directories
|
|
77 |
|
|
78 |
#------------------------------------------------------------------------
|
|
79 |
# texttitle/headerindex: text of title and header for index file
|
|
80 |
#------------------------------------------------------------------------
|
|
81 |
set texttitleindex = A-Z Index of Functions
|
|
82 |
set textheaderindex = A-Z Index of Functions
|
|
83 |
|
|
84 |
#------------------------------------------------------------------------
|
|
85 |
# texttitle/headerfiles: text of title and header for files
|
|
86 |
# name of file will be added at the end
|
|
87 |
#------------------------------------------------------------------------
|
|
88 |
set texttitlefiles = PROJEKTNAME: Function
|
|
89 |
set textheaderfiles = Documentation of
|
|
90 |
|
|
91 |
#------------------------------------------------------------------------
|
|
92 |
# frames: whether to use frames in layout (yes or no)
|
|
93 |
#------------------------------------------------------------------------
|
|
94 |
set frames = no
|
|
95 |
|
|
96 |
#------------------------------------------------------------------------
|
|
97 |
# filenametopframe: name of file including frame layout (highest level file)
|
|
98 |
# [default: index]
|
|
99 |
#------------------------------------------------------------------------
|
|
100 |
set filenametopframe = index
|
|
101 |
|
|
102 |
#------------------------------------------------------------------------
|
|
103 |
# textjumpindexglobal: text displayed for jump to index of all files
|
|
104 |
# (global)
|
|
105 |
# textjumpindexlocal: text displayed for jump to index of files in actual
|
|
106 |
# directory (local)
|
|
107 |
#------------------------------------------------------------------------
|
|
108 |
set textjumpindexglobal = Global Index (all files)
|
|
109 |
set textjumpindexlocal = Local Index (files in subdir)
|
|
110 |
|
|
111 |
#------------------------------------------------------------------------
|
|
112 |
# includesource: include source of m-files in documentation [YES|no]
|
|
113 |
#------------------------------------------------------------------------
|
|
114 |
set includesource = yes
|
|
115 |
|
|
116 |
#------------------------------------------------------------------------
|
|
117 |
# usecontentsm: use contents.m files as well for structured
|
|
118 |
# (hopefully) index [YES|no]
|
|
119 |
#------------------------------------------------------------------------
|
|
120 |
set usecontentsm = no
|
|
121 |
|
|
122 |
#------------------------------------------------------------------------
|
|
123 |
# includesource: write/update contents.m files [yes|NO]
|
|
124 |
#------------------------------------------------------------------------
|
|
125 |
set writecontentsm = no
|
|
126 |
|
|
127 |
#------------------------------------------------------------------------
|
|
128 |
# processtree: parse whole directory tree recursively [YES|no]
|
|
129 |
#------------------------------------------------------------------------
|
|
130 |
set processtree = yes
|
|
131 |
|
|
132 |
#------------------------------------------------------------------------
|
|
133 |
# producetree: produce tree for html-files in same structure than
|
|
134 |
# tree of m-files [yes|NO]
|
|
135 |
# if no, all files are saved in the same directory, often
|
|
136 |
# easier for outside linking to files
|
|
137 |
#------------------------------------------------------------------------
|
|
138 |
set producetree = no
|
|
139 |
|
|
140 |
#------------------------------------------------------------------------
|
|
141 |
# codebodyindex/files: HTML-code for adding to BODY tag
|
|
142 |
# can be used for defining colors and
|
|
143 |
# backgroundimages of the files
|
|
144 |
# No longer recommended, use the css file
|
|
145 |
#------------------------------------------------------------------------
|
|
146 |
set codebodyindex =
|
|
147 |
set codebodyfiles =
|
|
148 |
|
|
149 |
#------------------------------------------------------------------------
|
|
150 |
# codeheadmeta: HTML-code added in HEAD area, use for supplying META info
|
|
151 |
#------------------------------------------------------------------------
|
|
152 |
set codeheadmeta =
|
|
153 |
|
|
154 |
#------------------------------------------------------------------------
|
|
155 |
# codehr: HTML-code used to define a <HR>, do what you want
|
|
156 |
#------------------------------------------------------------------------
|
|
157 |
set codehr = <hr size="3" noshade="noshade" />
|
|
158 |
|
|
159 |
#------------------------------------------------------------------------
|
|
160 |
# codeheader: HTML-code added to <H*> tags, use for centering header text
|
|
161 |
# or changing the colour/size/font of the header text
|
|
162 |
#------------------------------------------------------------------------
|
|
163 |
set codeheader = align="center"
|
|
164 |
|
|
165 |
|
|
166 |
# End of parameter file
|