You can subscribe to this list here.
2002 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
(3) |
Sep
(15) |
Oct
(21) |
Nov
(18) |
Dec
(59) |
---|---|---|---|---|---|---|---|---|---|---|---|---|
2003 |
Jan
(43) |
Feb
(35) |
Mar
(78) |
Apr
(65) |
May
(163) |
Jun
(169) |
Jul
(137) |
Aug
(77) |
Sep
(47) |
Oct
(27) |
Nov
(43) |
Dec
(68) |
2004 |
Jan
(61) |
Feb
(39) |
Mar
(11) |
Apr
(42) |
May
(86) |
Jun
(82) |
Jul
(24) |
Aug
(26) |
Sep
(37) |
Oct
(62) |
Nov
(131) |
Dec
(43) |
2005 |
Jan
(31) |
Feb
(56) |
Mar
(65) |
Apr
(165) |
May
(106) |
Jun
(97) |
Jul
(65) |
Aug
(150) |
Sep
(78) |
Oct
(115) |
Nov
(41) |
Dec
(26) |
2006 |
Jan
(50) |
Feb
(39) |
Mar
(56) |
Apr
(67) |
May
(89) |
Jun
(68) |
Jul
(116) |
Aug
(65) |
Sep
(58) |
Oct
(103) |
Nov
(28) |
Dec
(52) |
2007 |
Jan
(92) |
Feb
(60) |
Mar
(124) |
Apr
(96) |
May
(69) |
Jun
(79) |
Jul
(25) |
Aug
(22) |
Sep
(7) |
Oct
(17) |
Nov
(27) |
Dec
(32) |
2008 |
Jan
(57) |
Feb
(87) |
Mar
(51) |
Apr
(43) |
May
(56) |
Jun
(62) |
Jul
(25) |
Aug
(82) |
Sep
(58) |
Oct
(42) |
Nov
(38) |
Dec
(86) |
2009 |
Jan
(50) |
Feb
(33) |
Mar
(84) |
Apr
(90) |
May
(109) |
Jun
(37) |
Jul
(22) |
Aug
(51) |
Sep
(93) |
Oct
(86) |
Nov
(31) |
Dec
(62) |
2010 |
Jan
(33) |
Feb
(57) |
Mar
(62) |
Apr
(43) |
May
(30) |
Jun
(49) |
Jul
(20) |
Aug
(40) |
Sep
(152) |
Oct
(38) |
Nov
(15) |
Dec
(32) |
2011 |
Jan
(29) |
Feb
(25) |
Mar
(65) |
Apr
(45) |
May
(27) |
Jun
(11) |
Jul
(14) |
Aug
(8) |
Sep
(13) |
Oct
(117) |
Nov
(60) |
Dec
(19) |
2012 |
Jan
(23) |
Feb
(32) |
Mar
(24) |
Apr
(41) |
May
(56) |
Jun
(24) |
Jul
(15) |
Aug
(11) |
Sep
(26) |
Oct
(21) |
Nov
(12) |
Dec
(31) |
2013 |
Jan
(32) |
Feb
(24) |
Mar
(39) |
Apr
(44) |
May
(44) |
Jun
(8) |
Jul
(9) |
Aug
(12) |
Sep
(34) |
Oct
(19) |
Nov
(5) |
Dec
(9) |
2014 |
Jan
(22) |
Feb
(12) |
Mar
(7) |
Apr
(2) |
May
(13) |
Jun
(17) |
Jul
(8) |
Aug
(10) |
Sep
(7) |
Oct
(4) |
Nov
|
Dec
(39) |
2015 |
Jan
(13) |
Feb
(12) |
Mar
(12) |
Apr
(40) |
May
(5) |
Jun
(22) |
Jul
(3) |
Aug
(42) |
Sep
(5) |
Oct
(10) |
Nov
|
Dec
(10) |
2016 |
Jan
(9) |
Feb
(43) |
Mar
(5) |
Apr
(14) |
May
(17) |
Jun
(5) |
Jul
(5) |
Aug
(22) |
Sep
(5) |
Oct
|
Nov
(4) |
Dec
(18) |
2017 |
Jan
(28) |
Feb
(29) |
Mar
(9) |
Apr
(23) |
May
(48) |
Jun
(5) |
Jul
(32) |
Aug
(9) |
Sep
(13) |
Oct
(13) |
Nov
(6) |
Dec
(4) |
2018 |
Jan
(6) |
Feb
(5) |
Mar
(1) |
Apr
(2) |
May
(5) |
Jun
(17) |
Jul
(12) |
Aug
(15) |
Sep
|
Oct
(2) |
Nov
|
Dec
|
2019 |
Jan
|
Feb
(6) |
Mar
(3) |
Apr
(5) |
May
(10) |
Jun
(6) |
Jul
(6) |
Aug
|
Sep
(11) |
Oct
(18) |
Nov
(10) |
Dec
(7) |
2020 |
Jan
(3) |
Feb
(14) |
Mar
(2) |
Apr
(1) |
May
(5) |
Jun
|
Jul
(1) |
Aug
(11) |
Sep
(8) |
Oct
|
Nov
(1) |
Dec
(14) |
2021 |
Jan
(7) |
Feb
(2) |
Mar
(1) |
Apr
(8) |
May
(23) |
Jun
(7) |
Jul
(10) |
Aug
(1) |
Sep
|
Oct
(7) |
Nov
(10) |
Dec
(2) |
2022 |
Jan
|
Feb
(21) |
Mar
|
Apr
(3) |
May
(7) |
Jun
(4) |
Jul
(1) |
Aug
|
Sep
(3) |
Oct
|
Nov
|
Dec
|
2023 |
Jan
(18) |
Feb
|
Mar
(1) |
Apr
|
May
(9) |
Jun
|
Jul
|
Aug
(5) |
Sep
|
Oct
|
Nov
|
Dec
|
2024 |
Jan
|
Feb
(2) |
Mar
(3) |
Apr
(5) |
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
From: Martin K. <alq...@gm...> - 2022-02-20 16:29:19
|
You're missing a space: .. class:: borderless M. Dne ne 20. 2. 2022 16:44 uživatel Wols Lists <ant...@yo...> napsal: > On 20/02/2022 15:22, David Goodger wrote: > > It appears that you're constructing an ordered list whose content > > contains line breaks. Maybe this will do what you want: > > > > 1. | I now want this > > | text properly left aligned. > > > > See > > > https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#line-blocks > > < > https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#line-blocks > > > > Thanks. But that seems to be - as it says - for where the LINE structure > is important. I don't care about the lines, it's a paragraph. > > > > If it's something more complicated, ".. class:: borderless" preceding a > > table may work. > > Which is where Marcelo left me - sticking "..class:: borderless" before > the table just prints "class borderless" before the table, and does > absolutely nothing to the table itself ... > > > > And it's not "malarkey", it's "markup". > > ;-) > > (but seriously, "malarkey" is derogatory, slightly insulting) > > > I think I understand the sentiment there, but as far as I can make out > this particular malarkey is not just markup, but it's python, css, and > god knows what else, all of which I've never got to grips with. So if > I'm using mildly offensive language, it's because I'm getting extremely > frustrated with all these words where I understand perfectly what they > SAY, but don't have a damn clue what they MEAN! :-) > > Cheers, > Wol > > > David Goodger > > > > > > David Goodger > > <https://david.goodger.org <https://david.goodger.org>> > > > > > > On Sat, Feb 19, 2022 at 8:00 PM Wol <ant...@yo... > > <mailto:ant...@yo...>> wrote: > > > > I'm trying to create a simple table, the sort that one would do on a > > typewriter using tabs. How on earth do you do it! > > > > Something simple like > > > > 1. I now want this > > text properly left aligned. > > > > Note that there is NO boxing around it - from what I can make out as > > soon as you tell Sphinx "this is a table" it goes and makes the table > > structure visible! But it's not a table I want - I just want tab > > indented text or similar! > > > > But as soon as I attempt to treat it like tab-indented, all my > > indentation gets screwed up and I end up with something like > > > > 1. I now want this > > text properly left aligned. > > > > This is oh so simple with tabs or fixed width fonts - why do so many > > modern systems find it almost impossible! > > > > Cheers, > > Wol > > > > > > _______________________________________________ > > Docutils-users mailing list > > Doc...@li... > > <mailto:Doc...@li...> > > https://lists.sourceforge.net/lists/listinfo/docutils-users > > <https://lists.sourceforge.net/lists/listinfo/docutils-users> > > > > Please use "Reply All" to reply to the list. > > > > > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. > |
From: Wols L. <ant...@yo...> - 2022-02-20 15:44:12
|
On 20/02/2022 15:22, David Goodger wrote: > It appears that you're constructing an ordered list whose content > contains line breaks. Maybe this will do what you want: > > 1. | I now want this > | text properly left aligned. > > See > https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#line-blocks > <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#line-blocks> Thanks. But that seems to be - as it says - for where the LINE structure is important. I don't care about the lines, it's a paragraph. > > If it's something more complicated, ".. class:: borderless" preceding a > table may work. Which is where Marcelo left me - sticking "..class:: borderless" before the table just prints "class borderless" before the table, and does absolutely nothing to the table itself ... > > And it's not "malarkey", it's "markup". > ;-) > (but seriously, "malarkey" is derogatory, slightly insulting) > I think I understand the sentiment there, but as far as I can make out this particular malarkey is not just markup, but it's python, css, and god knows what else, all of which I've never got to grips with. So if I'm using mildly offensive language, it's because I'm getting extremely frustrated with all these words where I understand perfectly what they SAY, but don't have a damn clue what they MEAN! :-) Cheers, Wol > David Goodger > > > David Goodger > <https://david.goodger.org <https://david.goodger.org>> > > > On Sat, Feb 19, 2022 at 8:00 PM Wol <ant...@yo... > <mailto:ant...@yo...>> wrote: > > I'm trying to create a simple table, the sort that one would do on a > typewriter using tabs. How on earth do you do it! > > Something simple like > > 1. I now want this > text properly left aligned. > > Note that there is NO boxing around it - from what I can make out as > soon as you tell Sphinx "this is a table" it goes and makes the table > structure visible! But it's not a table I want - I just want tab > indented text or similar! > > But as soon as I attempt to treat it like tab-indented, all my > indentation gets screwed up and I end up with something like > > 1. I now want this > text properly left aligned. > > This is oh so simple with tabs or fixed width fonts - why do so many > modern systems find it almost impossible! > > Cheers, > Wol > > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > <mailto:Doc...@li...> > https://lists.sourceforge.net/lists/listinfo/docutils-users > <https://lists.sourceforge.net/lists/listinfo/docutils-users> > > Please use "Reply All" to reply to the list. > |
From: David G. <go...@py...> - 2022-02-20 15:23:31
|
It appears that you're constructing an ordered list whose content contains line breaks. Maybe this will do what you want: 1. | I now want this | text properly left aligned. See https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#line-blocks If it's something more complicated, ".. class:: borderless" preceding a table may work. And it's not "malarkey", it's "markup". ;-) (but seriously, "malarkey" is derogatory, slightly insulting) David Goodger David Goodger <https://david.goodger.org> On Sat, Feb 19, 2022 at 8:00 PM Wol <ant...@yo...> wrote: > I'm trying to create a simple table, the sort that one would do on a > typewriter using tabs. How on earth do you do it! > > Something simple like > > 1. I now want this > text properly left aligned. > > Note that there is NO boxing around it - from what I can make out as > soon as you tell Sphinx "this is a table" it goes and makes the table > structure visible! But it's not a table I want - I just want tab > indented text or similar! > > But as soon as I attempt to treat it like tab-indented, all my > indentation gets screwed up and I end up with something like > > 1. I now want this > text properly left aligned. > > This is oh so simple with tabs or fixed width fonts - why do so many > modern systems find it almost impossible! > > Cheers, > Wol > > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. > |
From: Wols L. <ant...@yo...> - 2022-02-20 13:10:11
|
On 20/02/2022 01:44, Marcelo Huerta wrote: > Wol escribió el 19/2/2022 a las 21:10: > >> I'm trying to create a simple table, the sort that one would do on a >> typewriter using tabs. How on earth do you do it! > > Forget the typewriter. We're using computers. > >> This is oh so simple with tabs or fixed width fonts - why do so many >> modern >> systems find it almost impossible! > > Because currently markup languages tend to be semantic. We're not in the > age > of punchcards where the only document type is text and we force columns > with > spaces or tabs. And, of course, trying to align text that way doesn't > make any sense if you're using variable width fonts. > > What you're showing is either a table of a series of containers. > Presentation > is best left to the renderer. You are rendering to HTML and don't like the > table borders? Write your content as a table, add :class: borderless to > your table, and that's it. > Okay, done a bit of googling, ended up with this, and I've still got grid lines everywhere ... .. table:: :class: borderless =========== ========================================================= Item-Id - A character string (maximum 48 characters) which uniquely identifies an item within a file. The item-id may include any characters except system delimiters, however the use of blanks, single quotes, quotes, commas, and backslash characters may require special considerations. ... ... At least it compiles, which is more than my initial attempts :-) Cheers, Wol |
From: Wols L. <ant...@yo...> - 2022-02-20 09:27:56
|
On 20/02/2022 01:44, Marcelo Huerta wrote: > Wol escribió el 19/2/2022 a las 21:10: > >> I'm trying to create a simple table, the sort that one would do on a >> typewriter using tabs. How on earth do you do it! > > Forget the typewriter. We're using computers. > >> This is oh so simple with tabs or fixed width fonts - why do so many >> modern >> systems find it almost impossible! > > Because currently markup languages tend to be semantic. We're not in the > age > of punchcards where the only document type is text and we force columns > with > spaces or tabs. And, of course, trying to align text that way doesn't > make any sense if you're using variable width fonts. > > What you're showing is either a table of a series of containers. > Presentation > is best left to the renderer. You are rendering to HTML and don't like the > table borders? Write your content as a table, add :class: borderless to > your table, and that's it. > Thank you very much. What I'm *transcribing* is a document where they DID force columns with spaces and tabs :-) But yes, I was expecting to have to do something like that, I'm fine with it, I'm just completely new to all this malarkey and didn't have a clue *how* to do it. Thanks again, Wol |
From: Marcelo H. <mar...@gm...> - 2022-02-20 01:44:57
|
Wol escribió el 19/2/2022 a las 21:10: > I'm trying to create a simple table, the sort that one would do on a > typewriter using tabs. How on earth do you do it! Forget the typewriter. We're using computers. > This is oh so simple with tabs or fixed width fonts - why do so many modern > systems find it almost impossible! Because currently markup languages tend to be semantic. We're not in the age of punchcards where the only document type is text and we force columns with spaces or tabs. And, of course, trying to align text that way doesn't make any sense if you're using variable width fonts. What you're showing is either a table of a series of containers. Presentation is best left to the renderer. You are rendering to HTML and don't like the table borders? Write your content as a table, add :class: borderless to your table, and that's it. -- o-=< Marcelo >=-o |
From: Wol <ant...@yo...> - 2022-02-20 01:00:16
|
I'm trying to create a simple table, the sort that one would do on a typewriter using tabs. How on earth do you do it! Something simple like 1. I now want this text properly left aligned. Note that there is NO boxing around it - from what I can make out as soon as you tell Sphinx "this is a table" it goes and makes the table structure visible! But it's not a table I want - I just want tab indented text or similar! But as soon as I attempt to treat it like tab-indented, all my indentation gets screwed up and I end up with something like 1. I now want this text properly left aligned. This is oh so simple with tabs or fixed width fonts - why do so many modern systems find it almost impossible! Cheers, Wol |
From: Guenter M. <mi...@us...> - 2021-12-22 09:04:33
|
Dear Matt, On 2021-12-21, Matt Documatt wrote: > Hi, there are at least two projects trying to do the same - provide > type hints for Docutils. > In past, I used docutils-stub > (https://github.com/tk0miya/docutils-stubs), but it doesn't cover a few > past versions. It is the work of great Sphinx guy Takeshi Komya. > Recently, I discovered types-docutils > (https://pypi.org/project/types-docutils/) that look "official" as it > is part of typeshed. > Which one to use? Who maintains the second one? Both are 3rd party projects. While Takeshi Komya is a regular contributor to docutils-devel and the ticket system, types-docutils is completely independent. It seems to be a "community project" with several contributors visible in https://github.com/python/typeshed/tree/master/stubs/docutils. I am not aware of problem reports for either of them. After dropping support for Python 2.7, Docutils may start annotating public classes, functions, and methods. Günter |
From: Matt D. <ma...@do...> - 2021-12-21 09:43:23
|
Hi, there are at least two projects trying to do the same - provide type hints for Docutils. In past, I used docutils-stub (https://github.com/tk0miya/docutils-stubs), but it doesn't cover a few past versions. It is the work of great Sphinx guy Takeshi Komya. Recently, I discovered types-docutils (https://pypi.org/project/types-docutils/) that look "official" as it is part of typeshed. Which one to use? Who maintains the second one? -- Matt https://techwriter.documatt.com |
From: Martin K. <m...@ef...> - 2021-11-24 06:38:07
|
Thanks for sharing! What have been the advantages of using rST over raw latex, and why did you make that choice? Thanks, Martin On Tue, Nov 23, 2021 at 8:45 PM Nicolas P. Rougier (inria) < nic...@in...> wrote: > > It's a regular bibtex file but I use a \nocite{*} in the latex > template so it's not totally automated. > > Nicolas > > "Alan G. Isaac" <ala...@gm...> writes: > > > Wow! > > Thanks for sharing! > > > > Did you create the bibliography by hand? > > > > Alan Isaac > > > > > > On 11/23/2021 1:26 PM, Nicolas P. Rougier (inria) wrote: > >> Hi all, > >> I've just released an open access PDF book (on scientifif > >> visualization) using restructured text that I converted to > >> latex > >> with a slightly modified rst2latex.py script and for some pages > >> I > >> had no choice but to use raw-latex directives. I think the > >> result is > >> nice. > >> Book: > >> https://www.labri.fr/perso/nrougier/scientific-visualization.html > >> Sources: > >> https://github.com/rougier/scientific-visualization-book > >> Feel free to copy the book style if you like it. > >> Cheers, > >> Nicolas > >> > >> _______________________________________________ > >> Docutils-users mailing list > >> Doc...@li... > >> https://lists.sourceforge.net/lists/listinfo/docutils-users > >> Please use "Reply All" to reply to the list. > > > > > > _______________________________________________ > > Docutils-users mailing list > > Doc...@li... > > https://lists.sourceforge.net/lists/listinfo/docutils-users > > > > Please use "Reply All" to reply to the list. > > > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. > |
From: Nicolas P. R. (inria) <nic...@in...> - 2021-11-24 06:33:30
|
I find Latex markup/syntax a bit too intrusive when writing. Using rst was a great way to stick to content without paying too much attention to layout. Nicolas Martin Koutecký <m...@ef...> writes: > Thanks for sharing! > What have been the advantages of using rST over raw latex, and > why did > you make that choice? > Thanks, > Martin > > On Tue, Nov 23, 2021 at 8:45 PM Nicolas P. Rougier (inria) > <nic...@in...> wrote: > > It's a regular bibtex file but I use a \nocite{*} in the > latex > template so it's not totally automated. > > Nicolas > > "Alan G. Isaac" <ala...@gm...> writes: > > > Wow! > > Thanks for sharing! > > > > Did you create the bibliography by hand? > > > > Alan Isaac > > > > > > On 11/23/2021 1:26 PM, Nicolas P. Rougier (inria) wrote: > >> Hi all, > >> I've just released an open access PDF book (on scientifif > >> visualization) using restructured text that I converted > >> to > >> latex > >> with a slightly modified rst2latex.py script and for some > >> pages > >> I > >> had no choice but to use raw-latex directives. I think > >> the > >> result is > >> nice. > >> Book: > >> > https://www.labri.fr/perso/nrougier/scientific-visualization.html > >> Sources: > >> https://github.com/rougier/scientific-visualization-book > >> Feel free to copy the book style if you like it. > >> Cheers, > >> Nicolas > >> > >> _______________________________________________ > >> Docutils-users mailing list > >> Doc...@li... > >> https://lists.sourceforge.net/lists/listinfo/docutils-users > >> Please use "Reply All" to reply to the list. > > > > > > _______________________________________________ > > Docutils-users mailing list > > Doc...@li... > > https://lists.sourceforge.net/lists/listinfo/docutils-users > > > > Please use "Reply All" to reply to the list. > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. |
From: Nicolas P. R. (inria) <nic...@in...> - 2021-11-23 19:45:36
|
It's a regular bibtex file but I use a \nocite{*} in the latex template so it's not totally automated. Nicolas "Alan G. Isaac" <ala...@gm...> writes: > Wow! > Thanks for sharing! > > Did you create the bibliography by hand? > > Alan Isaac > > > On 11/23/2021 1:26 PM, Nicolas P. Rougier (inria) wrote: >> Hi all, >> I've just released an open access PDF book (on scientifif >> visualization) using restructured text that I converted to >> latex >> with a slightly modified rst2latex.py script and for some pages >> I >> had no choice but to use raw-latex directives. I think the >> result is >> nice. >> Book: >> https://www.labri.fr/perso/nrougier/scientific-visualization.html >> Sources: >> https://github.com/rougier/scientific-visualization-book >> Feel free to copy the book style if you like it. >> Cheers, >> Nicolas >> >> _______________________________________________ >> Docutils-users mailing list >> Doc...@li... >> https://lists.sourceforge.net/lists/listinfo/docutils-users >> Please use "Reply All" to reply to the list. > > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. |
From: Alan G. I. <ala...@gm...> - 2021-11-23 19:17:06
|
Wow! Thanks for sharing! Did you create the bibliography by hand? Alan Isaac On 11/23/2021 1:26 PM, Nicolas P. Rougier (inria) wrote: > > Hi all, > > I've just released an open access PDF book (on scientifif visualization) using restructured text that I converted to latex with a slightly modified rst2latex.py > script and for some pages I had no choice but to use raw-latex directives. I think the result is nice. > > Book: https://www.labri.fr/perso/nrougier/scientific-visualization.html > Sources: https://github.com/rougier/scientific-visualization-book > > Feel free to copy the book style if you like it. > Cheers, > Nicolas > > > _______________________________________________ > Docutils-users mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. |
From: Nicolas P. R. (inria) <nic...@in...> - 2021-11-23 18:33:55
|
Hi all, I've just released an open access PDF book (on scientifif visualization) using restructured text that I converted to latex with a slightly modified rst2latex.py script and for some pages I had no choice but to use raw-latex directives. I think the result is nice. Book: https://www.labri.fr/perso/nrougier/scientific-visualization.html Sources: https://github.com/rougier/scientific-visualization-book Feel free to copy the book style if you like it. Cheers, Nicolas |
From: engelbert g. <eng...@gm...> - 2021-11-23 17:58:10
|
Contents * nodes.Node.traverse() returns a list again to restore backwards compatibility (fixes bug #431). and Small bugfixes (see HISTORY_). |
From: Guenter M. <mi...@us...> - 2021-11-23 08:19:33
|
On 2021-11-23, Lilian Castro wrote: > Octocat Your friendly kraken... |
From: Lilian C. <lib...@gm...> - 2021-11-23 01:55:54
|
Octocat |
From: Andreas C. <And...@st...> - 2021-11-04 10:14:29
|
Never mind - I see its been available since 0.17 and now in 0.18 with `image_link` From: Andreas Christoffersen Sent: 4. november 2021 09:25 To: 'Doc...@li...' <Doc...@li...> Subject: rst2html - option to embed images in output? Rmarkdown embeds images in html files. It would be great if a similar option was available with docutils and rst2html. I often write documentation which I need to send via email and such. The html format is optimal - but embedding of images is necessary. This is my first time posting. Not yet subscribed to the mailinglist. Sincerely |
From: Andreas C. <And...@st...> - 2021-11-04 08:41:01
|
Rmarkdown embeds images in html files. It would be great if a similar option was available with docutils and rst2html. I often write documentation which I need to send via email and such. The html format is optimal - but embedding of images is necessary. This is my first time posting. Not yet subscribed to the mailinglist. Sincerely |
From: Guenter M. <mi...@us...> - 2021-10-30 21:20:01
|
On 2021-10-22, Alan G. Isaac wrote: > I am using rst2html5 with --no-footnote-backlinks. > This is supposed to turn off backlinks from citations too. > (Hmm; shd't these be separate? Anyway ...) > It does if the citation reference occurs only once. > But if the citation reference occurs multiple times, > then there is still a list of back references. > There shouldn't be; right? You are right. It is actually even worse, the once-referenced footnotes and citations contained a spurious closing tag making the HTML invalid. Fixed and tested locally, will be in 0.18.1. Thank you for the report, Günter |
From: engelbert g. <eng...@gm...> - 2021-10-26 12:55:25
|
done. Some Of The Changes ================== * Identifiers: During identifier normalization <https://docutils.sourceforge.io/docs/ref/rst/directives.html#identifier-normalization>, leading number and hyphen characters are no longer stripped from a reference name <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#reference-names>, if the id_prefix <https://docutils.sourceforge.io/docs/user/config.html#id-prefix> setting is non-empty. * HTML5: Use the semantic tag <aside> for footnote text and citations, topics (except abstract and toc), admonitions, and system messages. Use <nav> for the Table of Contents. Make "auto" table column widths the default: * Major refactoring and fixes/additions in docutils/utils/math/math2html.py and docutils/utils/math/latex2mathml.py For details consult https://docutils.sourceforge.io/RELEASE-NOTES.html |
From: Alan G. I. <ala...@gm...> - 2021-10-22 18:00:58
|
I am using rst2html5 with --no-footnote-backlinks. This is supposed to turn off backlinks from citations too. (Hmm; shd't these be separate? Anyway ...) It does if the citation reference occurs only once. But if the citation reference occurs multiple times, then there is still a list of back references. There shouldn't be; right? Thanks, Alan Isaac |
From: Pierre O. <os...@ce...> - 2021-10-12 13:38:57
|
On 12/10/2021 13:23, Guenter Milde wrote: > > Your example resembles example 7 in > https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#option-lists > > --an-even-longer-option > The description can also start on the next line. > > which also states the reasoning behind this behaviour. > Hmm... I completely missed that. :) > What is missing, is a caveat in the specification of definition lists: the > term may not start with a hyphen. This is now added in the repository. > That's a nice addition. Especially including a reference to how to escape around the issue. However I would also suggest some adjustments to the parts that tripped me up as I re-read the option list definition multiple times: > Option lists are two-column lists... ^^^^^^^^^^ > There must be at least two spaces between the option(s)... ^^^^^^^^^^^^^^^^^^^^^^^^^^^ > +----------------------------+-------------+ > | option [" " argument] " " | description | > +-------+--------------------+ | ^^^^ Perhaps a footnote or similar emphasizing that this has an exception? And should the permitted trailing single space be explicitly documented? > > Thank you for reporting, > No problem. Trying to spare the next person the head ache. :) Regards -- Pierre Ossman Software Development Cendio AB https://cendio.com Teknikringen 8 https://twitter.com/ThinLinc 583 30 Linköping https://facebook.com/ThinLinc Phone: +46-13-214600 A: Because it messes up the order in which people normally read text. Q: Why is top-posting such a bad thing? |
From: Guenter M. <mi...@us...> - 2021-10-12 11:24:13
|
Hej Pierre, On 2021-10-11, Pierre Ossman wrote in gmane.text.docutils.user: > Unfortunately there is a bug/deviation in the docutils implementation of > option lists compared to how they are described. This causes it to > misparse some definition lists as option lists instead. > E.g. this: > --something-that-looks-like-an-option > But it really isn't! We just like dashes! > Will result in an option list in the parsed doctree. But according to > the documentation an option list requires two or more spaces after the > option. Your example resembles example 7 in https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#option-lists --an-even-longer-option The description can also start on the next line. which also states the reasoning behind this behaviour. What is missing, is a caveat in the specification of definition lists: the term may not start with a hyphen. This is now added in the repository. Thank you for reporting, Günter |
From: Pierre O. <os...@ce...> - 2021-10-11 13:40:16
|
Unfortunately there is a bug/deviation in the docutils implementation of option lists compared to how they are described. This causes it to misparse some definition lists as option lists instead. E.g. this: --something-that-looks-like-an-option But it really isn't! We just like dashes! Will result in an option list in the parsed doctree. But according to the documentation an option list requires two or more spaces after the option. So this should really be a definition list. A casual glance at the code suggests that it is this regexp that is incorrect: 'option_marker': r'%(option)s(, %(option)s)*( +| ?$)' % pats, I don't think that last '| ?$' should be there. This code has been around for at least 19 years, and it even has a test that explicitly looks for this behaviour. So I'm not sure what to do here. Either the code or the documentation needs to change. Normally I'd advocate to fix the code, but I'm not so sure if there are people relying on this after it being around for so long. (not subscribed, so cc on replies would be appreciated) Regards -- Pierre Ossman Software Development Cendio AB https://cendio.com Teknikringen 8 https://twitter.com/ThinLinc 583 30 Linköping https://facebook.com/ThinLinc Phone: +46-13-214600 A: Because it messes up the order in which people normally read text. Q: Why is top-posting such a bad thing? |