From e538843f8fb8bc26bb22d56c5ecf31edacca8feb Mon Sep 17 00:00:00 2001 From: milde Date: Fri, 23 Oct 2009 19:49:19 +0000 Subject: Use the ``\\\\url`` command for URLs (breaks long URLs instead of writing into the margin). git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@6183 929543f6-e4f2-0310-98a6-ba3bd3dd1d04 --- docutils/docs/dev/todo.txt | 74 ++++++++++++++-------------------------------- 1 file changed, 23 insertions(+), 51 deletions(-) (limited to 'docutils/docs/dev') diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt index 739375198..14308e6e5 100644 --- a/docutils/docs/dev/todo.txt +++ b/docutils/docs/dev/todo.txt @@ -2029,6 +2029,10 @@ Which packages do we want to use? :bigfoot: texlive-latex-extra :footnote: texlive-latex-recommended :perpage: texlive-latex-extra + :ftnxtra: new on CTAN + fixes the issue of footnote inside \caption{}, + tabular environment and \section{} like commands. + .. Footnote FAQs: @@ -2263,70 +2267,38 @@ Ideas: -1 prevents passing of options to the "ucs" package. -wrapping URLs -````````````` - -Hyperlinks are not hyphenated; this leads to bad spacing. See -docs/user/rst/demo.txt 2.14 directives. - -See the thread "LaTeX writer: trouble with URLs" at docutils-devel and -http://www.tex.ac.uk/cgi-bin/texfaq2html?label=breaklinks - -Use \url to typeset URLs. With hyperref, - -* \nolinkurl is an alias for the url package's \url -* \url is equivalent to \href{URL}{\nolinkurl{URL}}. - -I don't think we need special support for the 'deception' case -`NAME `_ with NAME != URL1 and NAME a valid URL. - -Detection -^^^^^^^^^ - -* Test nodes for ``node[refuri] == node.astext()`` +problematic URLs +```````````````` -* Apply also to the content of the "uri-reference" role (once it is - implemented). +* ^^ LaTeX's special syntax for characters results in "strange" replacements + (both with \href and \url). -(Do we need an additional test with Docutils' default detection mechanism -states.Inliner.patterns.uri ?) + `file with ^^ <../strange^^name>`__: + `<../strange^^name>`__ +* Unbalanced braces, { or }, will fail (both with \href and \url):: -Layout/Font -^^^^^^^^^^^ + `file with { <../strange{name>`__ + `<../strange{name>`__ -We could ensure the same look as currently (normal text font for URLs) with -``\urlstyle{same}``, but I would stick to the LaTeX default and document the -configuration options. +Currently, a warning is written to the error output stream. -Fragility -^^^^^^^^^ +For correct printing, we can - The "\url" command is fragile, and its argument is likely to be very - fragile, but a defined-url is robust: +* use the \href command with "normal" escaped name argument, or +* define a url-command in the preamble :: -As \url is a very special, ``verb``-like command, escaping does not always -work. - -We need to check the conditions: - - If the argument contains any "%", "#", or "^^", or ends with "\", it - can't be used in the argument to another command. The argument must not - contain unbalanced braces. - -Escaping works for # and %:: + \urldef{\fragileURLi}\nolinkurl{myself%node@gateway.net} - \footnote{siehe \url{http://www.w3.org/XML/Schema\#dev}} - \footnote{siehe \url{http://example.org/Schema\%dev}} +but need to find a way to insert it as href argument. -For "^^", we can define a url-command in the preamble :: +The following fails:: - \urldef{\fragileURLi}\nolinkurl{myself%node@gateway.net} + \href{http://www.w3.org/XML/Schema^^dev}{\fragileURLi} -but need to find a way to insert it as href argument, as the following fails -:: +Use %-replacement like http://nowhere/url_with%28parens%29 ? - \href{http://www.w3.org/XML/Schema^^dev}{\fragileURLi} +-> does not work for file paths (with pdflatex and xpdf). add-stylesheet option -- cgit v1.2.1