Menu
▾
▴
docutils-develop
|
From: Petr V. <en...@us...> - 2020-08-26 15:47:23
|
--- ** [feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Wed Aug 26, 2020 03:47 PM UTC **Owner:** nobody Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: engelbert g. <gr...@us...> - 2020-08-29 11:28:04
|
i found on my lubuntu man 7 man:
Hypertext link macros
.UR url ... snip
.UE [trailer] ... snip
These macros have been supported since GNU Troff 1.20 (2009-01-05) and Heirloom Doctools Troff since (2016-02-17).
and the same man page online https://linux.die.net/man/7/man
with a .URL macro
any preferences any
---
** [feature-requests:#72] rst2man: Show reference targets**
**Status:** open
**Group:** Default
**Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin
**Last Updated:** Wed Aug 26, 2020 03:47 PM UTC
**Owner:** nobody
Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font.
Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost?
---
Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/
To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: engelbert g. <gr...@us...> - 2021-04-04 18:58:16
|
- **assigned_to**: engelbert gruber --- ** [feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Sat Aug 29, 2020 12:18 PM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: Jerry S. <jer...@ic...> - 2021-04-04 21:41:18
|
> love rocks,,,,,,,( I am still available Sent from my iPhone > On Apr 4, 2021, at 1:58 PM, engelbert gruber via Docutils-develop <doc...@li...> wrote: > > > assigned_to: engelbert gruber > [feature-requests:#72] rst2man: Show reference targets > > Status: open > Group: Default > Created: Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin > Last Updated: Sat Aug 29, 2020 12:18 PM UTC > Owner: engelbert gruber > > Currently, the manpage writer writes a reference like ALT TEXT <URL> as just ALT TEXT, with alternate font. > Would it be better to render it as, for example, ALT TEXT [URL], so the information is not lost? > > Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ > > To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. > > _______________________________________________ > Docutils-develop mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-develop > > Please use "Reply All" to reply to the list. |
|
From: Jerry S. <jer...@ic...> - 2021-04-04 23:12:32
|
> [I found a 7 man] yes all is good > Sent from my iPhone > On Apr 4, 2021, at 1:58 PM, engelbert gruber via Docutils-develop <doc...@li...> wrote: > > > assigned_to: engelbert gruber > [feature-requests:#72] rst2man: Show reference targets > > Status: open > Group: Default > Created: Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin > Last Updated: Sat Aug 29, 2020 12:18 PM UTC > Owner: engelbert gruber > > Currently, the manpage writer writes a reference like ALT TEXT <URL> as just ALT TEXT, with alternate font. > Would it be better to render it as, for example, ALT TEXT [URL], so the information is not lost? > > Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ > > To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. > > _______________________________________________ > Docutils-develop mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-develop > > Please use "Reply All" to reply to the list. |
|
From: engelbert g. <gr...@us...> - 2021-04-25 10:50:41
|
using .UR .UE properly requires knowing of the newline before
and the character following ... maybe doing it in the writer is less cumbersome ... but then is it man ?
~~~
def visit_reference(self, node):
"""E.g. link or email address."""
# external reference (URL)
if 'refuri' in node:
# first the description in alternate font
if node['refuri'] != node.astext():
self.body.append(self.defs['reference'][0])
self.body.append(node.astext())
self.body.append(self.defs['reference'][1])
# then the URI using .UR macros
# TODO how to know previous text ended with new line
self.body.append("\n.UR %s" % node['refuri'])
# .UE to end
# OR if not followed by punctuation mark add a blank
self.body.append("\n.UE \\ ")
# TODO if followed by punctuation mark do not add a blank
# self.body.append("\n.UE ")
raise nodes.SkipNode
self.body.append(self.defs['reference'][0])
~~~
---
** [feature-requests:#72] rst2man: Show reference targets**
**Status:** open
**Group:** Default
**Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin
**Last Updated:** Sun Apr 04, 2021 06:58 PM UTC
**Owner:** engelbert gruber
Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font.
Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost?
---
Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/
To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: engelbert g. <gr...@us...> - 2023-05-20 09:34:54
|
checking with pandoc ~~~ See the `Python home page <https://www.python.org>`_ for info. ~~~ is converted to ~~~ see See the Python home page (https://www.python.org) for info. ~~~ TODO - how man pages will be broken if references are included - modern web-references tend to be long ... a layout disaster so to say should the link be - in place - end of paragraph - in SEE ALSO - what does mandoc do/show --- **[feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Fri Apr 23, 2021 10:05 AM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: Günter M. <mi...@us...> - 2023-05-20 20:49:07
|
For printouts of links at a specified place, rST provides the [target-notes](https://docutils.sourceforge.io/docs/ref/rst/directives.html#target-footnotes) directive. --- **[feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Sat May 20, 2023 09:34 AM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: engelbert g. <gr...@us...> - 2023-08-04 10:10:21
|
line of thought * Reading a manpage on screen in a terminal is like a printout * printing links at the end, in or near section SEE ALSO might be far away plan * printing in place the one without label * printing at end of paragraph for labeled urls ? --- **[feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Sat May 20, 2023 08:49 PM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: Guenter M. <mi...@us...> - 2023-08-04 12:36:10
|
On 2023-08-04, engelbert gruber via Docutils-develop wrote:
> **[feature-requests:#72] rst2man: Show reference targets**
> **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin
> Currently, the manpage writer writes a reference like `ALT TEXT <URL>`
> as just `ALT TEXT`, with alternate font. Would it be better to render
> it as, for example, `ALT TEXT [URL]`, so the information is not lost?
> line of thought
> * Reading a manpage on screen in a terminal is like a printout
> * printing links at the end, in or near section SEE ALSO might be far away
> plan
> * printing in place the one without label
> * printing at end of paragraph for labeled urls ?
The `target-notes`__ directive creates a footnote for each external
target in the text at the place where it occures in the source, and
corresponding footnote references after each reference.
However the distinction is not done by labeled vs. anonymous links but by
explicit vs. implicit hyperlink targets::
Inlined targets like `du <ex1>`_ do not appear in the footnotes.
External targets like_ this are collected.
Also `anonymous targets`__
.. _like: ex2
__ ex3
.. target-notes::
__ https://docutils.sourceforge.io/docs/ref/rst/directives.html#target-footnotes
Suggestion:
* Print links with `implicit hyperlink targets
<https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html
#implicit-hyperlink-targets>`_ including the target in ``[]`` or
``<>``, whatever is more common in man pages).
* Add a paragraph recommending the "target-notes" directive for man
pages with explicit links to the manpage writer documentation.
The "target-notes" directive allows custom placement of the footnotes
containing the link targets.
This gives document authors a choice for link placement.
(Currently, the "target-notes" directive can only be used once in a document,
subsequent uses repeat the complete list with new footnote numbers.)
Günter
|
|
From: Dmitry S. <man...@us...> - 2023-08-05 16:24:52
|
Another possibility would be using the `.UR` / `.UE` macros to produce hyperlinks. They are described in groff_man(7) man page. The macros themselves are supported by groff since 2007, but the next groff version will enable them for terminal devices (using OSC 8 escape sequence). See groff commit 9dadd72a3c9cd40c20e06e80e918a68badf83b0f. Debian's groff version 1.23.0-1 (and newer) already includes support for them. --- **[feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Fri Aug 04, 2023 10:10 AM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: engelbert g. <gr...@us...> - 2023-08-07 12:29:08
|
That is my current solution, seams to work on my ubuntu's man and mandoc viewing. --- **[feature-requests:#72] rst2man: Show reference targets** **Status:** open **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Sat Aug 05, 2023 04:24 PM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
|
From: Guenter M. <mi...@us...> - 2023-08-08 07:58:51
|
On 2023-08-05, Dmitry Shachnev via Docutils-develop wrote: > > Currently, the manpage writer writes a reference like `ALT TEXT <URL>` > > as just `ALT TEXT`, with alternate font. Would it be better to render > > it as, for example, `ALT TEXT [URL]`, so the information is not lost? ... > Another possibility would be using the `.UR` / `.UE` macros to produce > hyperlinks. They are described in groff_man(7) man page. > The macros themselves are supported by groff since 2007, but the next > groff version will enable them for terminal devices (using OSC 8 escape > sequence). See groff commit 9dadd72a3c9cd40c20e06e80e918a68badf83b0f. > Debian's groff version 1.23.0-1 (and newer) already includes support > for them. How would this be handled by other (t)roff converters? Günter |
|
From: Dmitry S. <mi...@gm...> - 2023-08-09 17:21:04
|
Hi Günter! On Tue, Aug 08, 2023 at 07:58:28AM -0000, Guenter Milde via Docutils-develop wrote: > > Another possibility would be using the `.UR` / `.UE` macros to produce > > hyperlinks. They are described in groff_man(7) man page. > > > > The macros themselves are supported by groff since 2007, but the next > > groff version will enable them for terminal devices (using OSC 8 escape > > sequence). See groff commit 9dadd72a3c9cd40c20e06e80e918a68badf83b0f. > > > > Debian's groff version 1.23.0-1 (and newer) already includes support > > for them. > > How would this be handled by other (t)roff converters? What other implementations do we want to support? I thought we are already using some groff-specific macros, but I may be wrong. -- Dmitry Shachnev |
|
From: Guenter M. <mi...@us...> - 2023-08-10 10:41:21
|
On 2023-08-09, Dmitry Shachnev wrote: > On Tue, Aug 08, 2023 at 07:58:28AM -0000, Guenter Milde via Docutils-develop wrote: >> > Another possibility would be using the `.UR` / `.UE` macros to produce >> > hyperlinks. They are described in groff_man(7) man page. ... >> How would this be handled by other (t)roff converters? > What other implementations do we want to support? I remember discussions about the BSD versions but don't remember the outcome. Engelbert is our specialist for the man writer. Günter |
|
From: Dmitry S. <mi...@gm...> - 2023-08-10 12:32:39
|
On Thu, Aug 10, 2023 at 10:41:03AM -0000, Guenter Milde via Docutils-develop wrote:
> On 2023-08-09, Dmitry Shachnev wrote:
> > On Tue, Aug 08, 2023 at 07:58:28AM -0000, Guenter Milde via Docutils-develop wrote:
>
> >> > Another possibility would be using the `.UR` / `.UE` macros to produce
> >> > hyperlinks. They are described in groff_man(7) man page.
> ...
> >> How would this be handled by other (t)roff converters?
>
> > What other implementations do we want to support?
>
> I remember discussions about the BSD versions but don't remember the outcome.
> Engelbert is our specialist for the man writer.
FreeBSD's and OpenBSD's man(7) mention the .UR / .UE macros:
UR Begin a uniform resource identifier block. This is a non-standard
GNU extension. It has the following syntax:
.UR uri
link description to be shown
.UE
Although, they also say "Use the mdoc(7) language, instead", and mdoc(7) does
not mention these macros.
The same for .EX / .EE which we started using recently.
--
Dmitry Shachnev
|
|
From: engelbert g. <gr...@us...> - 2023-08-20 15:42:59
|
- **status**: open --> open-fixed - **Comment**: using .UR/.UE --- **[feature-requests:#72] rst2man: Show reference targets** **Status:** open-fixed **Group:** Default **Created:** Wed Aug 26, 2020 03:47 PM UTC by Petr Viktorin **Last Updated:** Mon Aug 07, 2023 12:29 PM UTC **Owner:** engelbert gruber Currently, the manpage writer writes a reference like `ALT TEXT <URL>` as just `ALT TEXT`, with alternate font. Would it be better to render it as, for example, `ALT TEXT [URL]`, so the information is not lost? --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/feature-requests/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |
×
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