mirror of https://github.com/interlegis/sigi.git
Sesostris Vieira
3 years ago
22 changed files with 0 additions and 3302 deletions
@ -1,8 +0,0 @@ |
|||||
home = /usr |
|
||||
implementation = CPython |
|
||||
version_info = 3.8.10.final.0 |
|
||||
virtualenv = 20.0.17 |
|
||||
include-system-site-packages = false |
|
||||
base-prefix = /usr |
|
||||
base-exec-prefix = /usr |
|
||||
base-executable = /usr/bin/python3 |
|
@ -1,142 +0,0 @@ |
|||||
******* |
|
||||
Install |
|
||||
******* |
|
||||
|
|
||||
PyGraphviz requires: |
|
||||
|
|
||||
- Python (version 3.7, 3.8, or 3.9) |
|
||||
- `Graphviz <https://www.graphviz.org/>`_ (version 2.42 or later) |
|
||||
- C/C++ Compiler |
|
||||
|
|
||||
.. note:: |
|
||||
These instructions assume you have Python and a C/C++ Compiler on your computer. |
|
||||
|
|
||||
.. warning:: |
|
||||
We recommend avoiding Anaconda and conda-forge to install Graphviz and PyGraphviz. |
|
||||
|
|
||||
Recommended |
|
||||
=========== |
|
||||
|
|
||||
We recommend installing Python packages using `pip and virtual environments |
|
||||
<https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/>`_. |
|
||||
|
|
||||
Linux |
|
||||
----- |
|
||||
|
|
||||
We recommend installing Graphviz using your Linux system's package manager. |
|
||||
Below are examples for some popular distributions. |
|
||||
|
|
||||
Ubuntu and Debian |
|
||||
~~~~~~~~~~~~~~~~~ |
|
||||
|
|
||||
.. code-block:: console |
|
||||
|
|
||||
$ sudo apt-get install graphviz graphviz-dev |
|
||||
$ pip install pygraphviz |
|
||||
|
|
||||
Fedora and Red Hat |
|
||||
~~~~~~~~~~~~~~~~~~ |
|
||||
|
|
||||
You may need to replace ``dnf`` with ``yum`` in the example below. |
|
||||
|
|
||||
.. code-block:: console |
|
||||
|
|
||||
$ sudo dnf install graphviz graphviz-devel |
|
||||
$ pip install pygraphviz |
|
||||
|
|
||||
macOS |
|
||||
----- |
|
||||
|
|
||||
We recommend installing Graphviz using the Homebrew package manager for macOS. |
|
||||
|
|
||||
Homebrew |
|
||||
~~~~~~~~ |
|
||||
|
|
||||
.. code-block:: console |
|
||||
|
|
||||
$ brew install graphviz |
|
||||
$ pip install pygraphviz |
|
||||
|
|
||||
Advanced |
|
||||
======== |
|
||||
|
|
||||
The two main difficulties are |
|
||||
1. installing Graphviz and |
|
||||
2. informing pip where Graphviz is installed. |
|
||||
|
|
||||
Providing path to Graphviz |
|
||||
-------------------------- |
|
||||
|
|
||||
If you've installed Graphviz and ``pip`` is unable to find Graphviz, then you need to |
|
||||
provide ``pip`` with the path(s) where it can find Graphviz. |
|
||||
To do this, you first need to figure out where the binary files, includes files, and |
|
||||
library files for Graphviz are located on your file system. |
|
||||
|
|
||||
Once you know where you've installed Graphviz, you will need to do something like |
|
||||
the following. There is an additional example using Chocolatey on Windows further |
|
||||
down the page. |
|
||||
|
|
||||
MacPorts |
|
||||
~~~~~~~~ |
|
||||
|
|
||||
.. note:: ``port install graphviz-devel`` installs an old developer release of Graphviz. |
|
||||
Hopefully, the MacPorts packagers will update Graphviz to a recent release. |
|
||||
Once that happens, you may want to use ``port install graphviz`` instead of |
|
||||
``port install graphviz-devel`` below. |
|
||||
There is an open ticket to upgrade MacPorts to version 2.46.0 here: |
|
||||
https://trac.macports.org/ticket/62165 |
|
||||
|
|
||||
.. code-block:: console |
|
||||
|
|
||||
$ port install graphviz-devel |
|
||||
$ pip install --global-option=build_ext \ |
|
||||
--global-option="-I/opt/local/include/" \ |
|
||||
--global-option="-L/opt/local/lib/" \ |
|
||||
pygraphviz |
|
||||
|
|
||||
.. _windows-install: |
|
||||
|
|
||||
Windows |
|
||||
------- |
|
||||
|
|
||||
Historically, installing Graphviz and PyGraphviz on Windows has been challenging. |
|
||||
Fortunately, the Graphviz developers are working to fix this and |
|
||||
their recent releases have much improved the situation. |
|
||||
|
|
||||
For this reason, PyGraphviz 1.7 only supports Graphviz 2.46.0 or higher on Windows. |
|
||||
We recommend either manually installing the official binary release of Graphviz or |
|
||||
using `Chocolatey <https://chocolatey.org/>`_, which has been updated to Graphviz 2.46.0. |
|
||||
|
|
||||
You may also need to install Visual C/C++, e.g. from here: |
|
||||
https://visualstudio.microsoft.com/visual-cpp-build-tools/ |
|
||||
|
|
||||
Assuming you have Python and Visual C/C++ installed, |
|
||||
we believe the following should work on Windows 10 (64 bit) using PowerShell. |
|
||||
|
|
||||
Manual download |
|
||||
~~~~~~~~~~~~~~~ |
|
||||
|
|
||||
1. Download and install 2.46.0 for Windows 10 (64-bit): |
|
||||
`stable_windows_10_cmake_Release_x64_graphviz-install-2.46.0-win64.exe |
|
||||
<https://gitlab.com/graphviz/graphviz/-/package_files/6164164/download>`_. |
|
||||
2. Install PyGraphviz via |
|
||||
|
|
||||
.. code-block:: console |
|
||||
|
|
||||
PS C:\> python -m pip install --global-option=build_ext ` |
|
||||
--global-option="-IC:\Program Files\Graphviz\include" ` |
|
||||
--global-option="-LC:\Program Files\Graphviz\lib" ` |
|
||||
pygraphviz |
|
||||
|
|
||||
Chocolatey |
|
||||
~~~~~~~~~~ |
|
||||
|
|
||||
.. code-block:: console |
|
||||
|
|
||||
PS C:\> choco install graphviz |
|
||||
PS C:\> python -m pip install --global-option=build_ext ` |
|
||||
--global-option="-IC:\Program Files\Graphviz\include" ` |
|
||||
--global-option="-LC:\Program Files\Graphviz\lib" ` |
|
||||
pygraphviz |
|
||||
|
|
||||
.. include:: reference/faq.rst |
|
@ -1,30 +0,0 @@ |
|||||
""" |
|
||||
Attributes |
|
||||
---------- |
|
||||
|
|
||||
Example illustrating how to set node, edge, and graph attributes for |
|
||||
visualization. |
|
||||
""" |
|
||||
|
|
||||
import pygraphviz as pgv |
|
||||
|
|
||||
# strict (no parallel edges) |
|
||||
# digraph |
|
||||
# with attribute rankdir set to 'LR' |
|
||||
A = pgv.AGraph(directed=True, strict=True, rankdir="LR") |
|
||||
# add node 1 with color red |
|
||||
A.add_node(1, color="red") |
|
||||
A.add_node(5, color="blue") |
|
||||
# add some edges |
|
||||
A.add_edge(1, 2, color="green") |
|
||||
A.add_edge(2, 3) |
|
||||
A.add_edge(1, 3) |
|
||||
A.add_edge(3, 4) |
|
||||
A.add_edge(3, 5) |
|
||||
A.add_edge(3, 6) |
|
||||
A.add_edge(4, 6) |
|
||||
# adjust a graph parameter |
|
||||
A.graph_attr["epsilon"] = "0.001" |
|
||||
print(A.string()) # print dot file to standard output |
|
||||
A.layout("dot") # layout with dot |
|
||||
A.draw("foo.png") # write to file |
|
@ -1,98 +0,0 @@ |
|||||
""" |
|
||||
Knuth Miles |
|
||||
=========== |
|
||||
|
|
||||
An example that shows how to add your own positions to nodes |
|
||||
and have graphviz "neato" position the edges. |
|
||||
|
|
||||
miles_graph() returns an undirected graph over the 128 US cities from |
|
||||
the datafile miles_dat.txt. |
|
||||
|
|
||||
This example is described in Section 1.1 in Knuth's book [1]_ [2]_. |
|
||||
|
|
||||
The data used in this example is copied from [2]_. The filename and |
|
||||
header have been modified to adhere to the request of the author to |
|
||||
not corrupt the original source file content and name. |
|
||||
|
|
||||
References. |
|
||||
----------- |
|
||||
.. [1] Donald E. Knuth, |
|
||||
"The Stanford GraphBase: A Platform for Combinatorial Computing", |
|
||||
ACM Press, New York, 1993. |
|
||||
.. [2] http://www-cs-faculty.stanford.edu/~knuth/sgb.html |
|
||||
""" |
|
||||
|
|
||||
__author__ = """Aric Hagberg (aric.hagberg@gmail.com)""" |
|
||||
|
|
||||
|
|
||||
def miles_graph(): |
|
||||
"""Return a graph from the data in miles_dat.txt. |
|
||||
|
|
||||
Edges are made between cities that are less then 300 miles apart. |
|
||||
""" |
|
||||
import math |
|
||||
import re |
|
||||
import gzip |
|
||||
|
|
||||
G = pgv.AGraph(name="miles_dat") |
|
||||
G.node_attr["shape"] = "circle" |
|
||||
G.node_attr["fixedsize"] = "true" |
|
||||
G.node_attr["fontsize"] = "8" |
|
||||
G.node_attr["style"] = "filled" |
|
||||
G.graph_attr["outputorder"] = "edgesfirst" |
|
||||
G.graph_attr["label"] = "miles_dat" |
|
||||
G.graph_attr["ratio"] = "1.0" |
|
||||
G.edge_attr["color"] = "#1100FF" |
|
||||
G.edge_attr["style"] = "setlinewidth(2)" |
|
||||
|
|
||||
cities = [] |
|
||||
for line in gzip.open("miles_dat.txt.gz", "rt"): |
|
||||
if line.startswith("*"): # skip comments |
|
||||
continue |
|
||||
numfind = re.compile(r"^\d+") |
|
||||
|
|
||||
if numfind.match(line): # this line is distances |
|
||||
dist = line.split() |
|
||||
for d in dist: |
|
||||
if float(d) < 300: # connect if closer then 300 miles |
|
||||
G.add_edge(city, cities[i]) |
|
||||
i = i + 1 |
|
||||
else: # this line is a city, position, population |
|
||||
i = 1 |
|
||||
(city, coordpop) = line.split("[") |
|
||||
cities.insert(0, city) |
|
||||
(coord, pop) = coordpop.split("]") |
|
||||
(y, x) = coord.split(",") |
|
||||
G.add_node(city) |
|
||||
n = G.get_node(city) |
|
||||
# assign positions, scale to be something reasonable in points |
|
||||
n.attr["pos"] = "%f,%f)" % ( |
|
||||
-(float(x) - 7000) / 10.0, |
|
||||
(float(y) - 2000) / 10.0, |
|
||||
) |
|
||||
# assign node size, in sqrt of 1,000,000's of people |
|
||||
d = math.sqrt(float(pop) / 1000000.0) |
|
||||
n.attr["height"] = "%s" % (d / 2) |
|
||||
n.attr["width"] = "%s" % (d / 2) |
|
||||
# assign node color |
|
||||
n.attr["fillcolor"] = "#0000%2x" % (int(d * 256)) |
|
||||
# empty labels |
|
||||
n.attr["label"] = " " |
|
||||
|
|
||||
return G |
|
||||
|
|
||||
|
|
||||
if __name__ == "__main__": |
|
||||
import warnings |
|
||||
import pygraphviz as pgv |
|
||||
|
|
||||
# ignore Graphviz warning messages |
|
||||
warnings.simplefilter("ignore", RuntimeWarning) |
|
||||
|
|
||||
G = miles_graph() |
|
||||
print("Loaded miles_dat.txt containing 128 cities.") |
|
||||
|
|
||||
G.write("miles.dot") |
|
||||
print("Wrote miles.dot") |
|
||||
G.draw("miles.png", prog="neato", args="-n2") |
|
||||
print("Wrote miles.png") |
|
@ -1,30 +0,0 @@ |
|||||
""" |
|
||||
Basic |
|
||||
===== |
|
||||
|
|
||||
A simple example to create a graphviz dot file and draw a graph. |
|
||||
""" |
|
||||
# Copyright (C) 2006 by |
|
||||
# Aric Hagberg <hagberg@lanl.gov> |
|
||||
# Dan Schult <dschult@colgate.edu> |
|
||||
# Manos Renieris, http://www.cs.brown.edu/~er/ |
|
||||
# Distributed with BSD license. |
|
||||
# All rights reserved, see LICENSE for details. |
|
||||
|
|
||||
|
|
||||
__author__ = """Aric Hagberg (hagberg@lanl.gov)""" |
|
||||
|
|
||||
import pygraphviz as pgv |
|
||||
|
|
||||
A = pgv.AGraph() |
|
||||
|
|
||||
A.add_edge(1, 2) |
|
||||
A.add_edge(2, 3) |
|
||||
A.add_edge(1, 3) |
|
||||
|
|
||||
print(A.string()) # print to screen |
|
||||
A.write("simple.dot") # write to simple.dot |
|
||||
|
|
||||
B = pgv.AGraph("simple.dot") # create a new graph from file |
|
||||
B.layout() # layout with default (neato) |
|
||||
B.draw("simple.png") # draw png |
|
@ -1,37 +0,0 @@ |
|||||
""" |
|
||||
Star |
|
||||
==== |
|
||||
|
|
||||
Create and draw a star with varying node properties. |
|
||||
""" |
|
||||
# Copyright (C) 2006 by |
|
||||
# Aric Hagberg <hagberg@lanl.gov> |
|
||||
# Dan Schult <dschult@colgate.edu> |
|
||||
# Manos Renieris, http://www.cs.brown.edu/~er/ |
|
||||
# Distributed with BSD license. |
|
||||
# All rights reserved, see LICENSE for details. |
|
||||
|
|
||||
|
|
||||
__author__ = """Aric Hagberg (hagberg@lanl.gov)""" |
|
||||
|
|
||||
from pygraphviz import * |
|
||||
|
|
||||
A = AGraph() |
|
||||
|
|
||||
# set some default node attributes |
|
||||
A.node_attr["style"] = "filled" |
|
||||
A.node_attr["shape"] = "circle" |
|
||||
A.node_attr["fixedsize"] = "true" |
|
||||
A.node_attr["fontcolor"] = "#FFFFFF" |
|
||||
|
|
||||
# make a star in shades of red |
|
||||
for i in range(1, 16): |
|
||||
A.add_edge(0, i) |
|
||||
n = A.get_node(i) |
|
||||
n.attr["fillcolor"] = "#%2x0000" % (i * 16) |
|
||||
n.attr["height"] = "%s" % (i / 16.0 + 0.5) |
|
||||
n.attr["width"] = "%s" % (i / 16.0 + 0.5) |
|
||||
|
|
||||
print(A.string()) # print to screen |
|
||||
A.write("star.dot") # write to simple.dot |
|
||||
A.draw("star.png", prog="circo") # draw to png using circo layout |
|
@ -1,23 +0,0 @@ |
|||||
""" |
|
||||
Subgraph |
|
||||
======== |
|
||||
|
|
||||
Specify a subgraph in pygraphviz. |
|
||||
""" |
|
||||
|
|
||||
import pygraphviz as pgv |
|
||||
|
|
||||
A = pgv.AGraph() |
|
||||
# add some edges |
|
||||
A.add_edge(1, 2) |
|
||||
A.add_edge(2, 3) |
|
||||
A.add_edge(1, 3) |
|
||||
A.add_edge(3, 4) |
|
||||
A.add_edge(3, 5) |
|
||||
A.add_edge(3, 6) |
|
||||
A.add_edge(4, 6) |
|
||||
# make a subgraph with rank='same' |
|
||||
B = A.add_subgraph([4, 5, 6], name="s1", rank="same") |
|
||||
B.graph_attr["rank"] = "same" |
|
||||
print(A.string()) # print dot file to standard output |
|
||||
A.draw("subgraph.png", prog="neato") |
|
@ -1,49 +0,0 @@ |
|||||
#!/usr/bin/env python |
|
||||
""" |
|
||||
Simple example for rendering a graph with the Django web framework. |
|
||||
See |
|
||||
http://www.djangoproject.com/ |
|
||||
and |
|
||||
http://www.djangobook.com/en/beta/chapter11/ |
|
||||
|
|
||||
""" |
|
||||
# Copyright (C) 2007 by |
|
||||
# Aric Hagberg <hagberg@lanl.gov> |
|
||||
# Dan Schult <dschult@colgate.edu> |
|
||||
# Manos Renieris, http://www.cs.brown.edu/~er/ |
|
||||
# Distributed with BSD license. |
|
||||
# All rights reserved, see LICENSE for details. |
|
||||
|
|
||||
|
|
||||
__author__ = """Aric Hagberg (hagberg@lanl.gov)""" |
|
||||
|
|
||||
try: |
|
||||
from django.http import HttpResponse |
|
||||
except ImportError: # this won't run without Django, print message |
|
||||
print("Django not found.") |
|
||||
|
|
||||
|
|
||||
def pygraphviz_graph(request): |
|
||||
import pygraphviz as P |
|
||||
|
|
||||
A = P.AGraph() # init empty graph |
|
||||
# set some default node attributes |
|
||||
A.node_attr["style"] = "filled" |
|
||||
A.node_attr["shape"] = "circle" |
|
||||
# Add edges (and nodes) |
|
||||
A.add_edge(1, 2) |
|
||||
A.add_edge(2, 3) |
|
||||
A.add_edge(1, 3) |
|
||||
A.layout() # layout with default (neato) |
|
||||
png = A.draw(format="png") # draw png |
|
||||
return HttpResponse(png, mimetype="image/png") |
|
||||
|
|
||||
|
|
||||
if __name__ == "__main__": |
|
||||
print( |
|
||||
"""This code works with the Django web framework |
|
||||
and should run as a django "view". |
|
||||
See djangoproject.com for info. |
|
||||
|
|
||||
""" |
|
||||
) |
|
@ -1,31 +0,0 @@ |
|||||
""" |
|
||||
Example showing use of unicode and UTF-8 encoding. |
|
||||
""" |
|
||||
|
|
||||
|
|
||||
import pygraphviz as pgv |
|
||||
|
|
||||
# specify UTF-8 encoding (it is the default) |
|
||||
A = pgv.AGraph(encoding="UTF-8") |
|
||||
|
|
||||
# nodes, attributes, etc can be strings or unicode |
|
||||
A.add_node(1, label="plain string") |
|
||||
A.add_node(2, label="unicode") |
|
||||
|
|
||||
# you can enter unicode text as |
|
||||
hello = "Здравствуйте!" |
|
||||
A.add_node(3, label=hello) |
|
||||
|
|
||||
# or using unicode code points |
|
||||
hello = "\u0417\u0434\u0440\u0430\u0432\u0441\u0442\u0432\u0443\u0439\u0442\u0435!" |
|
||||
A.add_node(hello) # unicode node label |
|
||||
|
|
||||
goodbye = "До свидания" |
|
||||
A.add_edge(1, hello, key=goodbye) |
|
||||
|
|
||||
A.add_edge("שלום", hello) |
|
||||
# A.add_edge(1,3,hello="こんにちは / コンニチハ") |
|
||||
A.add_edge(1, "こんにちは") |
|
||||
|
|
||||
print(A) # print to screen |
|
||||
A.write("utf8.dot") # write to simple.dot |
|
@ -1,270 +0,0 @@ |
|||||
.\" Title: csv2ods |
|
||||
.\" Author: Agustin Henze <agustinhenze at gmail.com> |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 01/04/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "CSV2ODS" "1" "01/04/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
csv2ods \- Create OpenDocument spreadsheet from comma separated values |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBcsv2ods\fR\ 'u |
|
||||
\fBcsv2ods\fR \-i\ \fIfile\&.csv\fR \-o\ \fIfile\&.ods\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
This program reads a file in CSV format \- table of columns delimited by commas, tabs or any other character\&. It then creates a spreadsheet\&. If a value looks like a number the cell is formatted as a number as well\&. |
|
||||
.SH "Options" |
|
||||
.PP |
|
||||
\-\-version |
|
||||
.RS 4 |
|
||||
Show program\'s version number and exit |
|
||||
.RE |
|
||||
.PP |
|
||||
\-h, \-\-help |
|
||||
.RS 4 |
|
||||
Show help message and exit |
|
||||
.RE |
|
||||
.PP |
|
||||
\-i \fIINPUT\fR, \-\-input=\fIINPUT\fR |
|
||||
.RS 4 |
|
||||
File input in csv\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-o \fIOUTPUT\fR, \-\-output=\fIOUTPUT\fR |
|
||||
.RS 4 |
|
||||
File output in ods\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-d \fIDELIMITER\fR, \-\-delimiter=\fIDELIMITER\fR |
|
||||
.RS 4 |
|
||||
Specifies a one\-character string to use as the field separator\&. It defaults to ","\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-c \fIENCODING\fR, \-\-encoding=\fIENCODING\fR |
|
||||
.RS 4 |
|
||||
Specifies the encoding the file csv\&. It defaults to utf\-8\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-t \fITABLENAME\fR, \-\-table=\fITABLENAME\fR |
|
||||
.RS 4 |
|
||||
The table name in the output file\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-s \fISKIPINITIALSPACE\fR, \-\-skipinitialspace=\fISKIPINITIALSPACE\fR |
|
||||
.RS 4 |
|
||||
Specifies how to interpret whitespace which immediately follows a delimiter\&. It defaults to False, which means that whitespace immediately following a delimiter is part of the following field\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-l \fILINETERMINATOR\fR, \-\-lineterminator=\fILINETERMINATOR\fR |
|
||||
.RS 4 |
|
||||
Specifies the character sequence which should terminate rows\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-q \fIQUOTING\fR, \-\-quoting=\fIQUOTING\fR |
|
||||
.RS 4 |
|
||||
It can take on any of the following module constants: 0 = QUOTE_MINIMAL means only when required, for example, when a field contains either the quotechar or the delimiter\&. 1 = QUOTE_ALL means that quotes are always placed around fields\&. 2 = QUOTE_NONNUMERIC means that quotes are always placed around fields which do not parse as integers or floating point numbers\&. 3 = QUOTE_NONE means that quotes are never placed around fields\&. It defaults is QUOTE_MINIMAL\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-e \fIESCAPECHAR\fR, \-\-escapechar=\fIESCAPECHAR\fR |
|
||||
.RS 4 |
|
||||
Specifies a one\-character string used to escape the delimiter when quoting is set to QUOTE_NONE\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-r \fIQUOTECHAR\fR, \-\-quotechar=\fIQUOTECHAR\fR |
|
||||
.RS 4 |
|
||||
Specifies a one\-character string to use as the quoting character\&. It defaults to "\&. |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
csv2ods \-i /etc/passwd \-o accounts\&.odt \-d: |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBAgustin Henze\fR <\&agustinhenze at gmail\&.com\&> |
|
||||
.RS 4 |
|
||||
Original author of csv\-ods\&.py |
|
||||
.RE |
|
Binary file not shown.
@ -1,232 +0,0 @@ |
|||||
.\" Title: mailodf |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "MAILODF" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
mailodf \- Email ODF file as HTML archive |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBmailodf\fR\ 'u |
|
||||
\fBmailodf\fR [\-f\ \fIfrom\fR] [\-s\ \fIsubject\fR] \fIinputfile\fR \fIrecipients\fR... |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
mailodf is a program that will create a MIME\-encapsulated web archive and then sends it as an email\&. Most email programs that understand HTML understands this format\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqInputfile\(rq |
|
||||
is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "References" |
|
||||
.RS 4 |
|
||||
HTTRACK (http://www\&.httrack\&.com/) can create such archives with the \-%M option\&. |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://en\&.wikipedia\&.org/wiki/MHTML |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://www\&.dsv\&.su\&.se/~jpalme/ietf/mhtml\&.html |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://users\&.otenet\&.gr/~geosp/kmhtconvert/ |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://www\&.faqs\&.org/rfcs/rfc2557\&.html |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
mailodf \-f lars\&.oppermann@sun\&.com \-s "F\&.Y\&.I" odf\-file |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
odf2mht |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,239 +0,0 @@ |
|||||
.\" Title: odf2mht |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODF2MHT" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odf2mht \- Convert ODF to HTML archive |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodf2mht\fR\ 'u |
|
||||
\fBodf2mht\fR \fIpath\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
\fBOdf2mht\fR |
|
||||
is a program that will create a MIME\-encapsulated web archive (\&.mht) format where images are preserved\&. The file can be read by Internet Explorer, MS\-Word and many email programs such as MS\-Outlook\&. It will write the web archive to stdout\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqPath\(rq |
|
||||
is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "References" |
|
||||
.RS 4 |
|
||||
HTTRACK (http://www\&.httrack\&.com/) can create such archives with the \-%M option\&. |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://en\&.wikipedia\&.org/wiki/MHTML |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://www\&.dsv\&.su\&.se/~jpalme/ietf/mhtml\&.html |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://users\&.otenet\&.gr/~geosp/kmhtconvert/ |
|
||||
.RE |
|
||||
.RS 4 |
|
||||
http://www\&.faqs\&.org/rfcs/rfc2557\&.html |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odf2mht example\&.odt >example\&.mht |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "Bugs" |
|
||||
.PP |
|
||||
IE6 seems to have problems with large MHT files\&. |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
|
|
||||
\fBodftools\fR(1), |
|
||||
\fBodf2war\fR(1), |
|
||||
\fBmailodf\fR(1) |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,221 +0,0 @@ |
|||||
.\" Title: odf2xhtml |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 01/04/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODF2XHTML" "1" "01/04/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odf2xhtml \- Convert ODF to HTML |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodf2xhtml\fR\ 'u |
|
||||
\fBodf2xhtml\fR [\-e] \fIpath\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
\fBodf2xhtml\fR |
|
||||
is a program that will create a webpage (\&.html) from the input file and will write the webpage to stdout\&. |
|
||||
.PP |
|
||||
"Path" is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "Options" |
|
||||
.PP |
|
||||
\-p, \-\-plain |
|
||||
.RS 4 |
|
||||
The \-p flag will generate HTML without CSS\&. |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odf2xhtml odf\-file |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
\fBodf2mht\fR(1) |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,231 +0,0 @@ |
|||||
.\" Title: odf2xml |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 01/04/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODF2XML" "1" "01/04/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odf2xml \- Create OpenDocument XML file from OD? package |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodf2xml\fR\ 'u |
|
||||
\fBodf2xml\fR [\-e] [\-o\ \fIoutputfile\fR] [\fIinputfile\fR] |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
OpenDocument can be a complete office document in a single XML file\&. The script will take an OpenDocument and create an XML file This is mainly useful XML processors such as XSL transformation\&. |
|
||||
.PP |
|
||||
.PP |
|
||||
"Inputfile" is assumed to be an OpenDocument file\&. If there is no inputfile, the program will read from standard input\&. |
|
||||
.SH "Options" |
|
||||
.PP |
|
||||
\-e |
|
||||
.RS 4 |
|
||||
Normally, images that are stored in the archive in the Pictures folder are ignored\&. Using the \-e flag will |
|
||||
\fIembed\fR |
|
||||
the images in the XML as base64\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-o \fIoutputfile\fR |
|
||||
.RS 4 |
|
||||
If output file is not specified output will be to standard out\&. |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odf2xml \-o file\&.xml testdocument\&.odt |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
\fBxml2odf\fR(1) |
|
||||
.SH "Bugs" |
|
||||
.PP |
|
||||
Doesn\'t handle external data \-\- images and such\&. |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,227 +0,0 @@ |
|||||
.\" Title: odfimgimport |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 01/04/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODFIMGIMPORT" "1" "01/04/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odfimgimport \- Import external images |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodfimgimport\fR\ 'u |
|
||||
\fBodfimgimport\fR [\-q] [\-o\ \fIoutputfile\fR] [\fIinputfile\fR] |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
If you copy and paste html from your webbrowser to your word processor, the pictures in the pasted text will still load the images from the Internet\&. This script will import all images into the OpenDocument file\&. |
|
||||
.PP |
|
||||
If you don\'t provide an input file, the program will read from stdin\&. If the program reads from stdin, it might not know how to resolve relative filenames\&. If you don\'t provide an output file, the program will import the pictures into the input file\&. |
|
||||
.SH "Options" |
|
||||
.PP |
|
||||
\-q |
|
||||
.RS 4 |
|
||||
If there are images that can\'t be imported, odfimgimport will write how many has failed\&. The \-q flag will prevent that\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-v |
|
||||
.RS 4 |
|
||||
Verbose: Prints the URL of every image it tries to import and the result\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-o \fIoutputfile\fR |
|
||||
.RS 4 |
|
||||
The file to save the output to\&. "\-" is stdout\&. Defaults to the input file\&. |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odfimgimport \-v \-o newfile\&.odt oldfile\&.odt |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,217 +0,0 @@ |
|||||
.\" Title: odflint |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODFLINT" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odflint \- Check ODF file for problems |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodflint\fR\ 'u |
|
||||
\fBodflint\fR \fIpath\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
\fBodflint\fR |
|
||||
is a program that will check an ODF file and give warning if it finds something suspect\&. It is not able to make a full validation due to the complexity of the schema\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqPath\(rq |
|
||||
is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odflint odf\-file |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "Bugs" |
|
||||
.PP |
|
||||
Validates all versions of ODF as if they are version 1\&.1\&. You\'ll therefore get some false positives if you check files that aren\'t generated by odfpy scripts\&. |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,277 +0,0 @@ |
|||||
.\" Title: odfmeta |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODFMETA" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odfmeta \- List or change the metadata of an ODF file |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodfmeta\fR\ 'u |
|
||||
\fBodfmeta\fR [\-l] [\-v] [\-V] [\-c] [\-d] [\-x\ \fImetafield\fR...] [\-X\ \fImetafield\fR...] [\-a\ \fImetafield\fR...] [\-A\ \fImetafield\fR...] [\-I\ \fImetafield\fR...] [\-o\ \fIpath\fR] \fIpath\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
\fBodfmeta\fR |
|
||||
is a program that will list or change the metadata in an OpenDocument file\&. This is useful for version control systems\&. You can change title, keywords, description etc\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqPath\(rq |
|
||||
is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "Options" |
|
||||
.PP |
|
||||
\-l |
|
||||
.RS 4 |
|
||||
List (extract) all known metadata fields\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-v or \-V |
|
||||
.RS 4 |
|
||||
Print the version number of the ODF document |
|
||||
\fIformat\fR\&. If you use \-V it will print "version:" before the number for compatibility with \-X\&. The version number can\'t be modified\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-c |
|
||||
.RS 4 |
|
||||
Make field values continous by normalizing white space\&. Might be convenient when postprocessing with standard (line oriented) text utilities\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-d |
|
||||
.RS 4 |
|
||||
Update the modification date to the current date and time\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-x \fImetafield\fR |
|
||||
.RS 4 |
|
||||
Extract the contents of this metafield from the file\&. Known field names are creation\-date, creator, date, description, editing\-cycles, editing\-duration, generator, initial\-creator, keyword, language, print\-date, printed\-by, subject, title, user\-defined\&. All other names are assumed to be user defined\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-X \fImetafield\fR |
|
||||
.RS 4 |
|
||||
Same as \-x, but also preserves/includes the field name\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-a \fImetafield\fR |
|
||||
.RS 4 |
|
||||
Append a custom metafield to the metadata; but only if a similar field does not exist yet\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-A \fImetafield\fR |
|
||||
.RS 4 |
|
||||
Append a custom metafield to the metadata in any case\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-I \fImetafield\fR |
|
||||
.RS 4 |
|
||||
Append a custom metafield to the metadata and remove any existing similar field\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-o \fIpath\fR |
|
||||
.RS 4 |
|
||||
Filename to write modified ODT file to\&. If no |
|
||||
\fB\-o\fR |
|
||||
option is provided, the ODT file will be written to stdout\&. |
|
||||
.RE |
|
||||
.SH "Examples" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odfmeta \-l odf\-file\&.odt |
|
||||
odfmeta \-I "title:The Little Engine That Could" \-A subject:I\-think\-I\-can \-o newfile\&.odt source\&.odt |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
|
|
||||
\fBformail\fR(1), |
|
||||
\fBid3tag\fR(1) |
|
||||
.SH "Bugs" |
|
||||
.PP |
|
||||
All known versions of OpenOffice\&.org keep only four <meta:user\-defined> elements\&. If you add more than those, you\'ll loose them next time you save with OpenOffice\&.org\&. KOffice keeps only one <meta:keyword> element\&. |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,213 +0,0 @@ |
|||||
.\" Title: odfoutline |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODFOUTLINE" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odfoutline \- Show outline of OpenDocument |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodfoutline\fR\ 'u |
|
||||
\fBodfoutline\fR \fIpath\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
odfoutline is a simple program that will show the headings in the file and the level the heading is\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqPath\(rq |
|
||||
is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odfoutline odf\-file |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
@ -1,267 +0,0 @@ |
|||||
.\" Title: odfuserfield |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "ODFUSERFIELD" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
odfuserfield \- List or change the user\-field declarations in an ODF file |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBodfuserfield\fR\ 'u |
|
||||
\fBodfuserfield\fR [\-l] [\-L] [\-x\ \fIfield\fR...] [\-X\ \fIfield\fR...] [\-s\ \fIfield:value\fR...] [\-o\ \fIpath\fR] \fIpath\fR |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
|
|
||||
\fBOdfuserfield\fR |
|
||||
is a program that will list or change the user variable declarations in an OpenDocument file\&. There are two kinds of variables in OpenDocument\&. Simple variables can take different values at different positions, throughout a document\&. User variables have the same value throughout a document\&. Due to the latter\'s global nature it is safe to change them with an external application\&. |
|
||||
.PP |
|
||||
Use |
|
||||
\fBodfuserfield\fR |
|
||||
to fill out form letters before printing or giving to the user\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqPath\(rq |
|
||||
is assumed to be an OpenDocument file of text, spreadsheet or presentation type\&. |
|
||||
.SH "Options" |
|
||||
.PP |
|
||||
\-l |
|
||||
.RS 4 |
|
||||
List (extract) all known user\-fields\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-L |
|
||||
.RS 4 |
|
||||
List (extract) all known user\-fields with type and value\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-x \fIfield\fR |
|
||||
.RS 4 |
|
||||
Extract the contents of this field from the file\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-X \fIfield\fR |
|
||||
.RS 4 |
|
||||
Same as \-x, but also preserves/includes the field name and type\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-s \fIfield:value\fR |
|
||||
.RS 4 |
|
||||
Set the value of an existing user field\&. The field type will be the same\&. |
|
||||
.RE |
|
||||
.PP |
|
||||
\-o \fIpath\fR |
|
||||
.RS 4 |
|
||||
Filename to write modified ODT file to\&. If no |
|
||||
\fB\-o\fR |
|
||||
option is provided, the ODT file will be written to stdout\&. |
|
||||
.RE |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
odfuserfield \-L odf\-file |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
|
|
||||
\fBformail\fR(1), |
|
||||
\fBid3tag\fR(1) |
|
||||
.SH "Todo" |
|
||||
.PP |
|
||||
Implement formulas\&. See OpenDocument v1\&.0 specification section 6\&.3\&.5\&. This requires a different syntax for \-s arguments\&. |
|
||||
.SH "Authors" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
||||
.PP |
|
||||
\fBMichael Howitz\fR |
|
||||
.br |
|
||||
gocept gmbh & co\&. kg |
|
||||
.RS 4 |
|
||||
Refactoring |
|
||||
.RE |
|
@ -1,225 +0,0 @@ |
|||||
.Dd May 18, 2004 |
|
||||
.\" ttx is not specific to any OS, but contrary to what groff_mdoc(7) |
|
||||
.\" seems to imply, entirely omitting the .Os macro causes 'BSD' to |
|
||||
.\" be used, so I give a zero-width space as its argument. |
|
||||
.Os \& |
|
||||
.\" The "FontTools Manual" argument apparently has no effect in |
|
||||
.\" groff 1.18.1. I think it is a bug in the -mdoc groff package. |
|
||||
.Dt TTX 1 "FontTools Manual" |
|
||||
.Sh NAME |
|
||||
.Nm ttx |
|
||||
.Nd tool for manipulating TrueType and OpenType fonts |
|
||||
.Sh SYNOPSIS |
|
||||
.Nm |
|
||||
.Bk |
|
||||
.Op Ar option ... |
|
||||
.Ek |
|
||||
.Bk |
|
||||
.Ar file ... |
|
||||
.Ek |
|
||||
.Sh DESCRIPTION |
|
||||
.Nm |
|
||||
is a tool for manipulating TrueType and OpenType fonts. It can convert |
|
||||
TrueType and OpenType fonts to and from an |
|
||||
.Tn XML Ns -based format called |
|
||||
.Tn TTX . |
|
||||
.Tn TTX |
|
||||
files have a |
|
||||
.Ql .ttx |
|
||||
extension. |
|
||||
.Pp |
|
||||
For each |
|
||||
.Ar file |
|
||||
argument it is given, |
|
||||
.Nm |
|
||||
detects whether it is a |
|
||||
.Ql .ttf , |
|
||||
.Ql .otf |
|
||||
or |
|
||||
.Ql .ttx |
|
||||
file and acts accordingly: if it is a |
|
||||
.Ql .ttf |
|
||||
or |
|
||||
.Ql .otf |
|
||||
file, it generates a |
|
||||
.Ql .ttx |
|
||||
file; if it is a |
|
||||
.Ql .ttx |
|
||||
file, it generates a |
|
||||
.Ql .ttf |
|
||||
or |
|
||||
.Ql .otf |
|
||||
file. |
|
||||
.Pp |
|
||||
By default, every output file is created in the same directory as the |
|
||||
corresponding input file and with the same name except for the |
|
||||
extension, which is substituted appropriately. |
|
||||
.Nm |
|
||||
never overwrites existing files; if necessary, it appends a suffix to |
|
||||
the output file name before the extension, as in |
|
||||
.Pa Arial#1.ttf . |
|
||||
.Ss "General options" |
|
||||
.Bl -tag -width ".Fl t Ar table" |
|
||||
.It Fl h |
|
||||
Display usage information. |
|
||||
.It Fl d Ar dir |
|
||||
Write the output files to directory |
|
||||
.Ar dir |
|
||||
instead of writing every output file to the same directory as the |
|
||||
corresponding input file. |
|
||||
.It Fl o Ar file |
|
||||
Write the output to |
|
||||
.Ar file |
|
||||
instead of writing it to the same directory as the |
|
||||
corresponding input file. |
|
||||
.It Fl v |
|
||||
Be verbose. Write more messages to the standard output describing what |
|
||||
is being done. |
|
||||
.It Fl a |
|
||||
Allow virtual glyphs ID's on compile or decompile. |
|
||||
.El |
|
||||
.Ss "Dump options" |
|
||||
The following options control the process of dumping font files |
|
||||
(TrueType or OpenType) to |
|
||||
.Tn TTX |
|
||||
files. |
|
||||
.Bl -tag -width ".Fl t Ar table" |
|
||||
.It Fl l |
|
||||
List table information. Instead of dumping the font to a |
|
||||
.Tn TTX |
|
||||
file, display minimal information about each table. |
|
||||
.It Fl t Ar table |
|
||||
Dump table |
|
||||
.Ar table . |
|
||||
This option may be given multiple times to dump several tables at |
|
||||
once. When not specified, all tables are dumped. |
|
||||
.It Fl x Ar table |
|
||||
Exclude table |
|
||||
.Ar table |
|
||||
from the list of tables to dump. This option may be given multiple |
|
||||
times to exclude several tables from the dump. The |
|
||||
.Fl t |
|
||||
and |
|
||||
.Fl x |
|
||||
options are mutually exclusive. |
|
||||
.It Fl s |
|
||||
Split tables. Dump each table to a separate |
|
||||
.Tn TTX |
|
||||
file and write (under the name that would have been used for the output |
|
||||
file if the |
|
||||
.Fl s |
|
||||
option had not been given) one small |
|
||||
.Tn TTX |
|
||||
file containing references to the individual table dump files. This |
|
||||
file can be used as input to |
|
||||
.Nm |
|
||||
as long as the referenced files can be found in the same directory. |
|
||||
.It Fl i |
|
||||
.\" XXX: I suppose OpenType programs (exist and) are also affected. |
|
||||
Don't disassemble TrueType instructions. When this option is specified, |
|
||||
all TrueType programs (glyph programs, the font program and the |
|
||||
pre-program) are written to the |
|
||||
.Tn TTX |
|
||||
file as hexadecimal data instead of |
|
||||
assembly. This saves some time and results in smaller |
|
||||
.Tn TTX |
|
||||
files. |
|
||||
.It Fl y Ar n |
|
||||
When decompiling a TrueType Collection (TTC) file, |
|
||||
decompile font number |
|
||||
.Ar n , |
|
||||
starting from 0. |
|
||||
.El |
|
||||
.Ss "Compilation options" |
|
||||
The following options control the process of compiling |
|
||||
.Tn TTX |
|
||||
files into font files (TrueType or OpenType): |
|
||||
.Bl -tag -width ".Fl t Ar table" |
|
||||
.It Fl m Ar fontfile |
|
||||
Merge the input |
|
||||
.Tn TTX |
|
||||
file |
|
||||
.Ar file |
|
||||
with |
|
||||
.Ar fontfile . |
|
||||
No more than one |
|
||||
.Ar file |
|
||||
argument can be specified when this option is used. |
|
||||
.It Fl b |
|
||||
Don't recalculate glyph bounding boxes. Use the values in the |
|
||||
.Tn TTX |
|
||||
file as is. |
|
||||
.El |
|
||||
.Sh "THE TTX FILE FORMAT" |
|
||||
You can find some information about the |
|
||||
.Tn TTX |
|
||||
file format in |
|
||||
.Pa documentation.html . |
|
||||
In particular, you will find in that file the list of tables understood by |
|
||||
.Nm |
|
||||
and the relations between TrueType GlyphIDs and the glyph names used in |
|
||||
.Tn TTX |
|
||||
files. |
|
||||
.Sh EXAMPLES |
|
||||
In the following examples, all files are read from and written to the |
|
||||
current directory. Additionally, the name given for the output file |
|
||||
assumes in every case that it did not exist before |
|
||||
.Nm |
|
||||
was invoked. |
|
||||
.Pp |
|
||||
Dump the TrueType font contained in |
|
||||
.Pa FreeSans.ttf |
|
||||
to |
|
||||
.Pa FreeSans.ttx : |
|
||||
.Pp |
|
||||
.Dl ttx FreeSans.ttf |
|
||||
.Pp |
|
||||
Compile |
|
||||
.Pa MyFont.ttx |
|
||||
into a TrueType or OpenType font file: |
|
||||
.Pp |
|
||||
.Dl ttx MyFont.ttx |
|
||||
.Pp |
|
||||
List the tables in |
|
||||
.Pa FreeSans.ttf |
|
||||
along with some information: |
|
||||
.Pp |
|
||||
.Dl ttx -l FreeSans.ttf |
|
||||
.Pp |
|
||||
Dump the |
|
||||
.Sq cmap |
|
||||
table from |
|
||||
.Pa FreeSans.ttf |
|
||||
to |
|
||||
.Pa FreeSans.ttx : |
|
||||
.Pp |
|
||||
.Dl ttx -t cmap FreeSans.ttf |
|
||||
.Sh NOTES |
|
||||
On MS\-Windows and MacOS, |
|
||||
.Nm |
|
||||
is available as a graphical application to which files can be dropped. |
|
||||
.Sh SEE ALSO |
|
||||
.Pa documentation.html |
|
||||
.Pp |
|
||||
.Xr fontforge 1 , |
|
||||
.Xr ftinfo 1 , |
|
||||
.Xr gfontview 1 , |
|
||||
.Xr xmbdfed 1 , |
|
||||
.Xr Font::TTF 3pm |
|
||||
.Sh AUTHORS |
|
||||
.Nm |
|
||||
was written by |
|
||||
.An -nosplit |
|
||||
.An "Just van Rossum" Aq just@letterror.com . |
|
||||
.Pp |
|
||||
This manual page was written by |
|
||||
.An "Florent Rougon" Aq f.rougon@free.fr |
|
||||
for the Debian GNU/Linux system based on the existing FontTools |
|
||||
documentation. It may be freely used, modified and distributed without |
|
||||
restrictions. |
|
||||
.\" For Emacs: |
|
||||
.\" Local Variables: |
|
||||
.\" fill-column: 72 |
|
||||
.\" sentence-end: "[.?!][]\"')}]*\\($\\| $\\| \\| \\)[ \n]*" |
|
||||
.\" sentence-end-double-space: t |
|
||||
.\" End: |
|
@ -1,235 +0,0 @@ |
|||||
.\" Title: xml2odf |
|
||||
.\" Author: S\(/oren Roug |
|
||||
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
|
||||
.\" Date: 03/15/2009 |
|
||||
.\" Manual: User commands |
|
||||
.\" Source: odfpy |
|
||||
.\" Language: English |
|
||||
.\" |
|
||||
.TH "XML2ODF" "1" "03/15/2009" "odfpy" "User commands" |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * (re)Define some macros |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" toupper - uppercase a string (locale-aware) |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de toupper |
|
||||
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
|
||||
\\$* |
|
||||
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH-xref - format a cross-reference to an SH section |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de SH-xref |
|
||||
.ie n \{\ |
|
||||
.\} |
|
||||
.toupper \\$* |
|
||||
.el \{\ |
|
||||
\\$* |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SH - level-one heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SH |
|
||||
.\" put an extra blank line of space above the head in non-TTY output |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.HTML-TAG ".NH \\n[an-level]" |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
\." make the size of the head bigger |
|
||||
.ps +3 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.ie n \{\ |
|
||||
.\" if n (TTY output), use uppercase |
|
||||
.toupper \\$* |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
.nr an-break-flag 0 |
|
||||
.\" if not n (not TTY), use normal case (not uppercase) |
|
||||
\\$1 |
|
||||
.in \\n[an-margin]u |
|
||||
.ti 0 |
|
||||
.\" if not n (not TTY), put a border/line under subheading |
|
||||
.sp -.6 |
|
||||
\l'\n(.lu' |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" SS - level-two heading that works better for non-TTY output |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de1 SS |
|
||||
.sp \\n[PD]u |
|
||||
.nr an-level 1 |
|
||||
.set-an-margin |
|
||||
.nr an-prevailing-indent \\n[IN] |
|
||||
.fi |
|
||||
.in \\n[IN]u |
|
||||
.ti \\n[SN]u |
|
||||
.it 1 an-trap |
|
||||
.nr an-no-space-flag 1 |
|
||||
.nr an-break-flag 1 |
|
||||
.ps \\n[PS-SS]u |
|
||||
\." make the size of the head bigger |
|
||||
.ps +2 |
|
||||
.ft B |
|
||||
.ne (2v + 1u) |
|
||||
.if \\n[.$] \&\\$* |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BB/BE - put background/screen (filled box) around block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BB |
|
||||
.if t \{\ |
|
||||
.sp -.5 |
|
||||
.br |
|
||||
.in +2n |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EB |
|
||||
.if t \{\ |
|
||||
.if "\\$2"adjust-for-leading-newline" \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.br |
|
||||
.di |
|
||||
.in |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BW \\n(.lu-\\n(.i |
|
||||
.nr BH \\n(dn+.5v |
|
||||
.ne \\n(BHu+.5v |
|
||||
.ie "\\$2"adjust-for-leading-newline" \{\ |
|
||||
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.el \{\ |
|
||||
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
|
||||
.\} |
|
||||
.in 0 |
|
||||
.sp -.5v |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.sp .5v |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.\" BM/EM - put colored marker in margin next to block of text |
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
||||
.de BM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.ll -2n |
|
||||
.gcolor red |
|
||||
.di BX |
|
||||
.\} |
|
||||
.. |
|
||||
.de EM |
|
||||
.if t \{\ |
|
||||
.br |
|
||||
.di |
|
||||
.ll |
|
||||
.gcolor |
|
||||
.nr BH \\n(dn |
|
||||
.ne \\n(BHu |
|
||||
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
|
||||
.in 0 |
|
||||
.nf |
|
||||
.BX |
|
||||
.in |
|
||||
.fi |
|
||||
.\} |
|
||||
.. |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * set default formatting |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" disable hyphenation |
|
||||
.nh |
|
||||
.\" disable justification (adjust text to left margin only) |
|
||||
.ad l |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.\" * MAIN CONTENT STARTS HERE * |
|
||||
.\" ----------------------------------------------------------------- |
|
||||
.SH "Name" |
|
||||
xml2odf \- Create ODF package from OpenDocument in XML form |
|
||||
.SH "Synopsis" |
|
||||
.fam C |
|
||||
.HP \w'\fBxml2odf\fR\ 'u |
|
||||
\fBxml2odf\fR [\-o\ \fIoutputfile\fR] [\-s] [\fIinputfile\fR] |
|
||||
.fam |
|
||||
.SH "Description" |
|
||||
.PP |
|
||||
OpenDocument can be a complete office document in a single XML file\&. The script will take such a document and create a package\&. This is mainly useful as a postprocesser of a program producing XML, such as a stylesheet\&. |
|
||||
.PP |
|
||||
|
|
||||
\(lqInputfile\(rq |
|
||||
is assumed to be an OpenDocument file in XML form\&. If there is no inputfile, the program will read from standard input\&. The flag \-s adds correct suffix to the filename according to what mime type is found in the XML file, in cause you don\'t know already what document type you are packaging\&. |
|
||||
.PP |
|
||||
If output file is not specified output will be to standard out\&. |
|
||||
.PP |
|
||||
Section 2\&.1\&.1 of |
|
||||
Open Document Format for Office Applications |
|
||||
says that the [content\&.xml] file contains the document content, along with the |
|
||||
\fIautomatic styles\fR |
|
||||
needed for the document content\&. The [styles\&.xml] file contains all the named styles of a document, along with the |
|
||||
\fIautomatic styles\fR |
|
||||
needed for the named styles\&. The application doesn\'t know which automatic style is needed for what, so it puts the same set of automatic styles into both files\&. |
|
||||
.PP |
|
||||
One could assume that the inverse operation would be easier, but OpenOffice\&.org is quite happy to use the same names for two different automatic styles\&. For instance, a style used inside <style:footer> can have the same name as one used inside <office:text> but be a different paragraph style\&. This is reported as bug #90494 (http://www\&.openoffice\&.org/issues/show_bug\&.cgi?id=90494) |
|
||||
.SH "Example" |
|
||||
.sp |
|
||||
.if n \{\ |
|
||||
.RS 4 |
|
||||
.\} |
|
||||
.fam C |
|
||||
.ps -1 |
|
||||
.nf |
|
||||
.if t \{\ |
|
||||
.sp -1 |
|
||||
.\} |
|
||||
.BB lightgray adjust-for-leading-newline |
|
||||
.sp -1 |
|
||||
|
|
||||
xml2odf \-o testdocument \-s xml\-file |
|
||||
.EB lightgray adjust-for-leading-newline |
|
||||
.if t \{\ |
|
||||
.sp 1 |
|
||||
.\} |
|
||||
.fi |
|
||||
.fam |
|
||||
.ps +1 |
|
||||
.if n \{\ |
|
||||
.RE |
|
||||
.\} |
|
||||
.SH "See Also" |
|
||||
.PP |
|
||||
|
|
||||
\fBodftools\fR(1), |
|
||||
\fBodf2xml\fR(1) |
|
||||
.SH "Bugs" |
|
||||
.PP |
|
||||
Doesn\'t handle external data \-\- images and such\&. |
|
||||
.PP |
|
||||
The library used for the parsing of XML expands empty elements from <element/> to <element></element>\&. It should not have an effect on the document parsing\&. |
|
||||
.SH "Author" |
|
||||
.PP |
|
||||
\fBS\(/oren Roug\fR |
|
||||
.RS 4 |
|
||||
Original author |
|
||||
.RE |
|
Loading…
Reference in new issue