Menu
▾
▴
docutils-develop
|
From: Julien T. L. <me...@fr...> - 2002-09-23 12:41:59
|
Hi list,
On Sep 23, 2002, at 12:25, gr...@us... was heard saying:
> i will check in the modifications into my sandbox (if it worls today this day)
Fine.
> * web-site is not a docinfo item so it will not be handled in the docinfo
> section. this is not recognizable in html as the handling is the same
> * in latex i might choose to put author and date under latex control.
Probably better visually.
BTW, I won't be able to complete my version of the Writer today -- I'm having
problems with py Python installation... and with ReST footnotes.
Please give me your opinion:
* the problem comes from the fact that footnote refs and footnote bodies are
separated in ReST, whereas in LaTeX, they're not.
* my first solution doesn't work (defining footnote bodies in the document
head, and referring to them afterward -- ugly)
* second solution: replace foonotes by captionless floats: this way refs and
defs can easily be separated. Example::
my note [1]_
.. [1] note body.
becomes (without backrefs)::
my note [\href{#note-1}{1}]
\begin{figure}{b} % at least put the notes at the bottom...
\hypertarget{note-1}
\footnotesize
[1] note body.
\end{figure}
This isn't very LaTeX-ish, but it works, and is easy to realize.
Footnote ordering will be the order of the defs, not of the refs, which
probably is unimportant.
What's your opinion about this method?
BTW, Handling bibliography references/definitons is, of course, easier, since
they're pretty much the same (struture-wise) in ReST and LaTeX.
.. troll:
Next problem: tables. Sounds hard, hmm? Well, I'm pushing stuff in
and popping stuff off the self.context stack quite a lot... hoping
it works.
And, surprisingly, it does!
Cheers,
--
Julien T. Letessier email: co...@me...
ENSIMAG Student web: http://www.mezis.net
|
|
From: <gr...@us...> - 2002-09-23 13:57:51
|
On Mon, 23 Sep 2002, Julien T. Letessier wrote:
> On Sep 23, 2002, at 12:25, gr...@us... was heard saying:
>
> > i will check in the modifications into my sandbox (if it worls today this day)
>
> Fine.
>
> > * web-site is not a docinfo item so it will not be handled in the docinfo
> > section. this is not recognizable in html as the handling is the same
>
> > * in latex i might choose to put author and date under latex control.
>
> Probably better visually.
but looks different, the latex article layout
TITLE
author
date
:contact: me@home :web-site: http:www
and contact is in the table for docinfo website is a list following the docinfo.
>
> BTW, I won't be able to complete my version of the Writer today -- I'm having
> problems with py Python installation... and with ReST footnotes.
>
you could send me your version for review ?
> Please give me your opinion:
>
> * the problem comes from the fact that footnote refs and footnote bodies are
> separated in ReST, whereas in LaTeX, they're not.
>
> * my first solution doesn't work (defining footnote bodies in the document
> head, and referring to them afterward -- ugly)
>
> * second solution: replace foonotes by captionless floats: this way refs and
> defs can easily be separated. Example::
>
SNIP ---
> What's your opinion about this method?
the problem as i understand is you want to jump from/to the footnote.
i would use footnote (at least for now) aslong as footnotes are on the same
page i donot care to jump.
cheers
--
BINGO: Reporting
--- Engelbert Gruber -------+
SSG Fintl,Gruber,Lassnig /
A6410 Telfs Untermarkt 9 /
Tel. ++43-5262-64727 ----+
|
|
From: Julien T. L. <me...@fr...> - 2002-09-23 14:38:12
|
Hey list, it's me again. On Sep 23, 2002, at 15:27, gr...@us... was heard saying: > you could send me your version for review ? No problem. > > * the problem comes from the fact that footnote refs and footnote bodies are > > separated in ReST, whereas in LaTeX, they're not. > > > > * my first solution doesn't work (defining footnote bodies in the document > > head, and referring to them afterward -- ugly) > > > > * second solution: replace foonotes by captionless floats: this way refs and > > defs can easily be separated. Example:: > > the problem as i understand is you want to jump from/to the footnote. > i would use footnote (at least for now) aslong as footnotes are on the same > page i donot care to jump. The problem is not with jumping (aka hyperlinks). It's that if you want to use ``\footnote``, you have to give the note's contents at the moment you encounter the reference, i.e. when you visit the ``footnote_reference`` node. But the contents are only defined once you've visited the ``footnote`` node, which generelly comes *after* the reference! Anyways, using ``\footnote`` is not an option, since in ReST, footnotes can be multiply referenced, which is impossible in LaTeX if you use the ``\footnote`` command (AFAIK). And, as I humbly want to state, the figure-footnote solution (as presented in my previous mail) works, and allows the LaTeX writer to be fully ReST compliant (as far as footnotes are concerned). .. troll:: "Donald, don't use footnotes in your books." -- Mrs. Donald E. Knuth, in 'The TeXbook, vol. 1' Cheers, -- Julien T. Letessier email: co...@me... ENSIMAG Student web: http://www.mezis.net |
|
From: Richard J. <rj...@ek...> - 2002-09-23 21:52:29
|
On Tue, 24 Sep 2002 12:38 am, Julien T. Letessier wrote:
> Hey list, it's me again.
>
> On Sep 23, 2002, at 15:27, gr...@us... was heard saying:
> > you could send me your version for review ?
>
> No problem.
>
> > > * the problem comes from the fact that footnote refs and footnote
> > > bodies are separated in ReST, whereas in LaTeX, they're not.
> > >
> > > * my first solution doesn't work (defining footnote bodies in the
> > > document head, and referring to them afterward -- ugly)
> > >
> > > * second solution: replace foonotes by captionless floats: this way
> > > refs and defs can easily be separated. Example::
> >
> > the problem as i understand is you want to jump from/to the footnote.
> > i would use footnote (at least for now) aslong as footnotes are on the
> > same page i donot care to jump.
>
> The problem is not with jumping (aka hyperlinks). It's that if you want to
> use ``\footnote``, you have to give the note's contents at the moment you
> encounter the reference, i.e. when you visit the ``footnote_reference``
> node.
>
> But the contents are only defined once you've visited the ``footnote``
> node, which generelly comes *after* the reference!
Can't you search the DOM for the footnote body, based on the reference? If
not, can you maybe have a simple transform that runs pre-writer that replaces
footnote ref/footnote with a single footnote node?
Richard
|
|
From: David G. <go...@us...> - 2002-09-24 02:38:08
|
Richard Jones wrote: > Can't you search the DOM for the footnote body, based on the reference? In fact, all footnotes are kept track of while processing the document. ``document.footnotes``, ``document.footnote_refs``, ``document.autofootnotes``, etc. Take a look at docutils/nodes.py, ``class document``, for details. Use the "--dump-internals" command-line option to see what's stored where. > If not, can you maybe have a simple transform that runs pre-writer that > replaces footnote ref/footnote with a single footnote node? I believe the difficulty in TeX is that a footnote is assumed to have only one reference. I.e., you can't say [1]_ and then say [1]_ again somewhere else. I'll leave it to those with real TeX knowledge (i.e., not me!) to figure out a solution. -- David Goodger <go...@us...> Open-source projects: - Python Docutils: http://docutils.sourceforge.net/ (includes reStructuredText: http://docutils.sf.net/rst.html) - The Go Tools Project: http://gotools.sourceforge.net/ |
|
From: <pf...@ar...> - 2002-09-24 08:31:39
|
Hi,
David Goodger:
> I believe the difficulty in TeX is that a footnote is assumed to have only
> one reference. I.e., you can't say [1]_ and then say [1]_ again somewhere
> else. I'll leave it to those with real TeX knowledge (i.e., not me!) to
> figure out a solution.
This will happen very seldom, so I propose the following solution:
Emit a LaTeX
\footnote{\label{<FOOTNOTE_IDENTIFIER>}FOOTNOTE_TEXT}
macro at the first encountered reference. At the second, third and so on
reference emit a LaTeX
\footnote{see footnote \ref{FOOTNOTE_IDENTIFIER} on
page \pagref{FOOTNOTE_IDENTIFIER}.}
This is not perfect but would deal with the situation in a reasonable way.
The LaTeX writer should also pay attention to the fact, that
standard LaTeX does not allow to construct footnotes inside tabular
material. I advise to use the tabularx environment and to add a
\usepackage{tabularx} into the header section. This shouldn't be a
problem, since tabularx may be considered as Standard LaTeX today:
It was even documented in LaTeX companion from 1994.
Using the LaTeX writer and pdflatex would offer a decent
reST to PDF converter.
Regards, Peter
--
Peter Funk, Oldenburger Str.86, D-27777 Ganderkesee, Germany
office: +49 421 20419-0 (ArtCom GmbH, Grazer Str.8, D-28359 Bremen, Germany)
|
|
From: <gr...@us...> - 2002-09-24 10:16:40
|
On Tue, 24 Sep 2002, Peter Funk wrote:
> The LaTeX writer should also pay attention to the fact, that
> standard LaTeX does not allow to construct footnotes inside tabular
> material. I advise to use the tabularx environment and to add a
> \usepackage{tabularx} into the header section. This shouldn't be a
> problem, since tabularx may be considered as Standard LaTeX today:
> It was even documented in LaTeX companion from 1994.
>
how about using longtable and supertabular so that tables can span
pages ?
> Using the LaTeX writer and pdflatex would offer a decent
> reST to PDF converter.
right it does
>
--
BINGO: professionally create virtual services
--- Engelbert Gruber -------+
SSG Fintl,Gruber,Lassnig /
A6410 Telfs Untermarkt 9 /
Tel. ++43-5262-64727 ----+
|
×
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.
Thanks for helping keep SourceForge clean.
X