aboutsummaryrefslogtreecommitdiff
path: root/dists
diff options
context:
space:
mode:
Diffstat (limited to 'dists')
-rw-r--r--dists/riscos/manual/stronghelp.lua341
1 files changed, 341 insertions, 0 deletions
diff --git a/dists/riscos/manual/stronghelp.lua b/dists/riscos/manual/stronghelp.lua
new file mode 100644
index 0000000000..ef17589dd7
--- /dev/null
+++ b/dists/riscos/manual/stronghelp.lua
@@ -0,0 +1,341 @@
+-- This is a custom writer for pandoc. It produces output suitable
+-- for use in a StrongHelp manual. Not all functionalilty is currently
+-- implemented.
+--
+-- Invoke with: pandoc -t stronghelp.lua
+--
+-- Note: you need not have lua installed on your system to use this
+-- custom writer. However, if you do have lua installed, you can
+-- use it to test changes to the script. 'lua stronghelp.lua' will
+-- produce informative error messages if your code contains
+-- syntax errors.
+
+-- Character escaping
+local function escape(s, in_attribute)
+ return s:gsub("[<>$\\]",
+ function(x)
+ if x == '<' then
+ return '\\<'
+ elseif x == '>' then
+ return '\\>'
+ elseif x == '$' then
+ return '\\$'
+ elseif x == '\\' then
+ return '\\\\'
+ else
+ return x
+ end
+ end)
+end
+
+local function convertPath(s)
+ local path = s:gsub("[./]",
+ function(x)
+ if x == '.' then
+ return '/'
+ elseif x == '/' then
+ return '.'
+ else
+ return x
+ end
+ end)
+ path = string.gsub(path, "/md", "")
+ return path;
+end
+
+-- Helper function to convert an attributes table into
+-- a string that can be put into HTML tags.
+local function attributes(attr)
+ local attr_table = {}
+ for x,y in pairs(attr) do
+ if y and y ~= "" then
+ table.insert(attr_table, ' ' .. x .. '="' .. escape(y,true) .. '"')
+ end
+ end
+ return table.concat(attr_table)
+end
+
+-- Helper function to look up an attribute by name from
+-- an attributes table.
+-- TODO: Is this necessary?
+local function getattribute(attr, name)
+ local attr_table = {}
+ for x,y in pairs(attr) do
+ if x == name then
+ do return escape(y,true) end
+ end
+ end
+ return ""
+end
+
+-- Table to store footnotes, so they can be included at the end.
+local notes = {}
+
+-- Blocksep is used to separate block elements.
+function Blocksep()
+ return "\n\n"
+end
+
+-- This function is called once for the whole document. Parameters:
+-- body is a string, metadata is a table, variables is a table.
+-- This gives you a fragment. You could use the metadata table to
+-- fill variables in a custom lua template. Or, pass `--template=...`
+-- to pandoc, and pandoc will add do the template processing as
+-- usual.
+function Doc(body, metadata, variables)
+ local buffer = {}
+ local function add(s)
+ table.insert(buffer, s)
+ end
+ add(body)
+ if #notes > 0 then
+ for _,note in pairs(notes) do
+ add(note)
+ end
+ end
+ return "#Indent +4\n" .. table.concat(buffer, "") .. "\n#Indent\n"
+end
+
+-- The functions that follow render corresponding pandoc elements.
+-- s is always a string, attr is always a table of attributes, and
+-- items is always an array of strings (the items in a list).
+-- Comments indicate the types of other variables.
+
+function Str(s)
+ return escape(s)
+end
+
+function Space()
+ return " "
+end
+
+function SoftBreak()
+ return " "
+end
+
+function LineBreak()
+ return "\n"
+end
+
+function Emph(s)
+ return "{/}" .. s .. "{/}"
+end
+
+function Strong(s)
+ return "{*}" .. s .. "{*}"
+end
+
+function Subscript(s)
+ -- TODO
+ return s
+end
+
+function Superscript(s)
+ -- TODO
+ return s
+end
+
+function SmallCaps(s)
+ -- TODO
+ return s
+end
+
+function Strikeout(s)
+ -- TODO
+ return s
+end
+
+function Link(s, src, tit, attr)
+ -- escape(tit,true)
+ if string.find(src, "://") or string.find(src, "mailto:") then
+ return "<" .. s .. "=>#URL " .. escape(src,true) .. ">"
+ elseif string.sub(src, 1, 1) == '#' then
+ return "<" .. s .. "=>#TAG " .. escape(string.sub(src,2),true) .. ">"
+ else
+ return "<" .. s .. "=>" .. convertPath(escape(src,true)) .. ">"
+ end
+end
+
+function Image(s, src, tit, attr)
+ -- TODO
+ return s
+end
+
+function Code(s, attr)
+ return "{FCode}" .. escape(s) .. "{F}"
+end
+
+function InlineMath(s)
+ return "\\(" .. escape(s) .. "\\)"
+end
+
+function DisplayMath(s)
+ return "\\[" .. escape(s) .. "\\]"
+end
+
+function SingleQuoted(s)
+ return "'" .. s .. "'"
+end
+
+function DoubleQuoted(s)
+ return '"' .. s .. '"'
+end
+
+
+function Note(s)
+ local num = #notes + 1
+ -- add a list item with the note to the note table.
+ table.insert(notes, '#Tag fn' .. num .. '\n' .. num .. ")\t" .. s .. '\n')
+ -- return the footnote reference, linked to the note.
+ return '<[' .. num .. ']=>#TAG fn' .. num .. '>'
+end
+
+function Span(s, attr)
+ -- TODO
+ return s
+end
+
+function RawInline(format, str)
+ -- TODO
+ return ''
+end
+
+function Cite(s, cs)
+ -- TODO
+ return s
+end
+
+function Plain(s)
+ return s
+end
+
+function Para(s)
+ return s
+end
+
+-- lev is an integer, the header level.
+function Header(lev, s, attr)
+ return "#Tag " .. getattribute(attr, "id") .. "\n" .. "#fH" .. lev .. "\n" .. s .. "\n#f\n"
+end
+
+function BlockQuote(s)
+ return "#Indent +6\n" .. s .. "\n#Indent\n"
+end
+
+function HorizontalRule()
+ return "#Line\n"
+end
+
+function LineBlock(ls)
+ -- TODO
+ return table.concat(ls, '\n')
+end
+
+function CodeBlock(s, attr)
+ -- TODO: attr.class and string.match(' ' .. attr.class .. ' ',' dot ')
+ return "#fCode\n" .. escape(s) .. "\n#f"
+end
+
+function BulletList(items)
+ local buffer = {}
+ for _, item in pairs(items) do
+ table.insert(buffer, " •\t" .. string.gsub(string.gsub(item, "\n", "\n\t"), "\n\t#", "\n#") .. "\n")
+ end
+ return "#Indent +4\n" .. table.concat(buffer, "") .. "#Indent\n"
+end
+
+function OrderedList(items)
+ local buffer = {}
+ for _, item in pairs(items) do
+ table.insert(buffer, _ .. ")\t" .. string.gsub(string.gsub(item, "\n", "\n\t"), "\n\t#", "\n#") .. "\n")
+ end
+ return "#Indent +4\n" .. table.concat(buffer, "") .. "#Indent\n"
+end
+
+function DefinitionList(items)
+ local buffer = {}
+ for _,item in pairs(items) do
+ local k, v = next(item)
+ table.insert(buffer, k .. "\t" .. table.concat(v,"\n\t") .. "\n")
+ end
+ return "#Indent +4\n" .. table.concat(buffer, "") .. "#Indent\n"
+end
+
+-- Convert pandoc alignment to something StrongHelp can use.
+-- align is AlignLeft, AlignRight, AlignCenter, or AlignDefault.
+function stronghelp_align(align)
+ if align == 'AlignLeft' then
+ return 'Left'
+ elseif align == 'AlignRight' then
+ return 'Right'
+ elseif align == 'AlignCenter' then
+ return 'Centre'
+ else
+ return 'Left'
+ end
+end
+
+function CaptionedImage(src, tit, caption, attr)
+ -- TODO
+ return tit .. '\n' .. caption .. '\n'
+end
+
+-- Caption is a string, aligns is an array of strings,
+-- widths is an array of floats, headers is an array of
+-- strings, rows is an array of arrays of strings.
+function Table(caption, aligns, widths, headers, rows)
+ local buffer = {}
+ local function add(s)
+ table.insert(buffer, s)
+ end
+ add("#Tab\n")
+ if caption ~= "" then
+ add(caption .. "\n")
+ end
+ local header_row = {}
+ local empty_header = true
+ for i, h in pairs(headers) do
+ table.insert(header_row,h .. '\t')
+ empty_header = empty_header and h == ""
+ end
+ if empty_header then
+ head = ""
+ else
+ local cells = {}
+ for _,h in pairs(header_row) do
+ table.insert(cells, h)
+ end
+ add('{*}' .. table.concat(cells,'\t') .. '{*}\n')
+ end
+ for _, row in pairs(rows) do
+ local cells = {}
+ for i,c in pairs(row) do
+ table.insert(cells, c)
+ end
+ add(table.concat(cells,'\t') .. '\n')
+ end
+ add("#Tab\n")
+ return table.concat(buffer,'')
+end
+
+function RawBlock(format, str)
+ -- TODO
+ return ''
+end
+
+function Div(s, attr)
+ -- TODO
+ return s
+end
+
+-- The following code will produce runtime warnings when you haven't defined
+-- all of the functions you need for the custom writer, so it's useful
+-- to include when you're working on a writer.
+local meta = {}
+meta.__index =
+ function(_, key)
+ io.stderr:write(string.format("WARNING: Undefined function '%s'\n",key))
+ return function() return "" end
+ end
+setmetatable(_G, meta)
+