## docutils-users — General discussions, questions, help requests.

You can subscribe to this list here.

2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 Jan Feb Mar Apr May Jun Jul Aug (3) Sep (15) Oct (21) Nov (18) Dec (59) Jan (43) Feb (35) Mar (78) Apr (65) May (163) Jun (169) Jul (137) Aug (77) Sep (47) Oct (27) Nov (43) Dec (68) Jan (61) Feb (39) Mar (11) Apr (42) May (86) Jun (82) Jul (24) Aug (26) Sep (37) Oct (62) Nov (131) Dec (43) Jan (31) Feb (56) Mar (65) Apr (165) May (106) Jun (97) Jul (65) Aug (150) Sep (78) Oct (115) Nov (41) Dec (26) Jan (50) Feb (39) Mar (56) Apr (67) May (89) Jun (68) Jul (116) Aug (65) Sep (58) Oct (103) Nov (28) Dec (52) Jan (92) Feb (60) Mar (124) Apr (96) May (69) Jun (79) Jul (25) Aug (22) Sep (7) Oct (17) Nov (27) Dec (32) Jan (57) Feb (87) Mar (51) Apr (43) May (56) Jun (62) Jul (25) Aug (82) Sep (58) Oct (42) Nov (38) Dec (86) Jan (50) Feb (33) Mar (84) Apr (90) May (109) Jun (37) Jul (22) Aug (51) Sep (93) Oct (86) Nov (31) Dec (62) Jan (33) Feb (57) Mar (62) Apr (43) May (30) Jun (49) Jul (20) Aug (40) Sep (152) Oct (38) Nov (15) Dec (32) Jan (29) Feb (25) Mar (65) Apr (45) May (27) Jun (11) Jul (14) Aug (8) Sep (13) Oct (117) Nov (60) Dec (19) Jan (23) Feb (32) Mar (24) Apr (41) May (56) Jun (24) Jul (15) Aug (11) Sep (26) Oct (21) Nov (12) Dec (31) Jan (32) Feb (24) Mar (39) Apr (44) May (44) Jun (8) Jul (9) Aug (12) Sep (34) Oct (19) Nov (5) Dec (9) Jan (22) Feb (12) Mar (7) Apr (2) May (13) Jun (17) Jul (8) Aug (10) Sep (7) Oct (4) Nov Dec (39) Jan (13) Feb (12) Mar (12) Apr (40) May (5) Jun (22) Jul (3) Aug (42) Sep (5) Oct (10) Nov Dec (10) Jan (9) Feb (43) Mar (5) Apr (14) May (17) Jun (5) Jul (5) Aug (22) Sep (5) Oct Nov (4) Dec (18) Jan (28) Feb (29) Mar (9) Apr (23) May (48) Jun (5) Jul (32) Aug (9) Sep (7) Oct Nov Dec

Showing results of 7793

1 2 3 .. 312 > >> (Page 1 of 312)
 Re: [Docutils-users] What classes and ids generates rst2html5? From: Leonhard Küper - 2017-09-21 09:28:48 I totally forgot: Thank you! :D On Sat, 16 Sep 2017 18:31:22 +0000 (UTC) Guenter Milde via Docutils-users wrote: > On 2017-09-16, Leonhard Küper wrote: > > Hello. > > > > I want to generate html from restructuered text and I want to style it. > > What selectors are generated? > > There is no dedicated documentation. You could look in the sources > (modules _html_base.py and html5/__init__.py in docutils/writers/). > The simplest way is to just try it out. > > > Are there some tips what the generated > > html could look like and how to style proper? > > Have a look at the examples in tests/functional/expected. > There you can also compare html4css1 and html5 output. > > The CSS style files in docutils/writers/html5_polyglott/ are also good > examples and comprehensive comments. > > Günter > > > > ------------------------------------------------------------------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Docutils-users mailing list > Docutils-users@... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. 
 Re: [Docutils-users] Approach for resolving unknown references with pure docutils From: David Goodger - 2017-09-21 04:19:51 On Wed, Sep 20, 2017 at 9:29 PM, Tony N wrote: > Docutils Users, This should be on the docutils-develop list. > Currently, sphinx has an infrastructure geared toward resolving unknown > references. I have not been able to find an approach for a custom reference > resolver mentioned before on the list. > > What would the best approach be for wiring in a callback to resolve missing > references with pure docutils? Not exactly sure what you're talking about. Examples go a long way. I'm guessing you're talking about resolving hyperlink references. (I don't like to guess; please don't make me.) > If it’s a transformer, when and where would > would it be added/applied? Transforms, not "transformers". Docutils has one Transformer, docutils.transforms.Transformer, which stores and applies Transforms. > (It appears the other reference resolvers in > docutils are in the Reader). The hook you're looking for is here: docutils/__init__.py::TransformSpec.unknown_reference_resolvers For an example, see sandbox/mmgilbe/rst.py, the original MoinMoin/Docutils interface code. > P.S. An aside, parsers/rst/states.py has an unused > UnknownInterpretedRoleError exception. OK... Do you have a point, other than this showing up in linter output? David Goodger ; 
 [Docutils-users] Approach for resolving unknown references with pure docutils From: Tony N - 2017-09-21 02:54:06 Attachments: Message as HTML Docutils Users, Currently, sphinx has an infrastructure geared toward resolving unknown references. I have not been able to find an approach for a custom reference resolver mentioned before on the list. What would the best approach be for wiring in a callback to resolve missing references with pure docutils? If it’s a transformer, when and where would would it be added/applied? (It appears the other reference resolvers in docutils are in the Reader). Tony P.S. An aside, parsers/rst/states.py has an unused UnknownInterpretedRoleError exception. 
 Re: [Docutils-users] What classes and ids generates rst2html5? From: Guenter Milde - 2017-09-16 18:31:45 On 2017-09-16, Leonhard Küper wrote: > Hello. > I want to generate html from restructuered text and I want to style it. > What selectors are generated? There is no dedicated documentation. You could look in the sources (modules _html_base.py and html5/__init__.py in docutils/writers/). The simplest way is to just try it out. > Are there some tips what the generated > html could look like and how to style proper? Have a look at the examples in tests/functional/expected. There you can also compare html4css1 and html5 output. The CSS style files in docutils/writers/html5_polyglott/ are also good examples and comprehensive comments. Günter 
 [Docutils-users] What classes and ids generates rst2html5? From: Leonhard Küper - 2017-09-16 13:26:19 Hello. I want to generate html from restructuered text and I want to style it. What selectors are generated? Are there some tips what the generated html could look like and how to style proper? Sincerely Leonhard 
 Re: [Docutils-users] Unicode issue in rst2html5 utility From: Guenter Milde - 2017-09-15 22:25:53 On 2017-09-15, Michal Dabski wrote: Dear Michal, thank you for the report. > I'm not subscribed to the mailing list, just wanted to raise an issue I > found while making messages using Django's makemessage command with > docutils installed. > I'm getting the following message: > $python manage.py makemessages > CommandError: errors happened while running xgettext on rst2html5.py > xgettext: ./bin/rst2html5.py:2: Unknown encoding "utf8". Proceeding with > ASCII instead. > xgettext: Non-ASCII comment at or before ./bin/rst2html5.py:3. > Please specify the source encoding through --from-code or through a comment > as specified in http://www.python.org/peps/pep-0263.html. > It looks like "utf8" is not a valid encoding, surely it should be "utf-8"? According to the Python documentation, both "utf-8" and "utf8" are valid aliases for the "utf_8" codec and the file is processed without problem by Python. OTOH, all other source files use the utf-8 alias in the source encoding comment, so we will change this for inner consistency. Thanks, Günter   [Docutils-users] Unicode issue in rst2html5 utility From: Michal Dabski - 2017-09-15 15:19:03 Attachments: Message as HTML Hi, I'm not subscribed to the mailing list, just wanted to raise an issue I found while making messages using Django's makemessage command with docutils installed. I'm getting the following message:$ python manage.py makemessages CommandError: errors happened while running xgettext on rst2html5.py xgettext: ./bin/rst2html5.py:2: Unknown encoding "utf8". Proceeding with ASCII instead. xgettext: Non-ASCII comment at or before ./bin/rst2html5.py:3. Please specify the source encoding through --from-code or through a comment as specified in http://www.python.org/peps/pep-0263.html. It looks like "utf8" is not a valid encoding, surely it should be "utf-8"? -- Michal Dabski Chief Technical Officer MEG Support Tools 
 Re: [Docutils-users] rst2html5.py on mac doesn't support --embed-stylesheet and other options? From: engelbert gruber - 2017-08-27 18:11:35 Attachments: Message as HTML On 25 August 2017 at 10:23, Lee Griffiths wrote: > He simply did pip install docutils. > I just tried this here. with a lot pip uninstall and rm, because i have plenty of docutils in 3.6 and 2.7 and ... but in the end rst2html5.py no longer worked i did :: pip install docutils the installation is in :: /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html5.py and :: /Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages :: > rst2html5.py --version rst2html5.py (Docutils 0.14, Python 2.7.10, on darwin) > rst2html5.py --help Usage ===== rst2html5.py [options] [ []] HTML-Specific Options --------------------- --template= Specify the template file (UTF-8 encoded). Default is "/Library/Frameworks/Python.framework/Versions/2.7/lib /python2.7/site-packages/docutils/writers/html5_polygl ot/template.txt". --stylesheet= Comma separated list of stylesheet URLs. Overrides previous --stylesheet and --stylesheet-path settings. --stylesheet-path= Comma separated list of stylesheet paths. Relative paths are expanded if a matching file is found in the --stylesheet-dirs. With --link-stylesheet, the path is rewritten relative to the output HTML file. Default: "minimal.css,plain.css" --embed-stylesheet Embed the stylesheet(s) in the output HTML file. The stylesheet files must be accessible during processing. This is the default. --link-stylesheet Link to the stylesheet(s) in the output HTML file. Default: embed stylesheets. --stylesheet-dirs= Comma-separated list of directories where stylesheets are found. Used by --stylesheet-path when expanding relative path arguments. Default: "['.', '/Library/Fra meworks/Python.framework/Versions/2.7/lib/python2.7 /site-packages/docutils/writers/html5_polyglot']" --initial-he > Can you think of anything that would go "wrong" here that would somehow > have his version of rst2html5.py being nothing like ours? > and in his version --help does not show the same stylesheet options then there must be another writer directory somewhere ? > > On 24 August 2017 at 16:50, engelbert gruber > wrote: > >> strange >> >> >> rst2html5.py (Docutils 0.14, Python 2.7.10, on darwin) >> >> --help >> >> HTML-Specific Options >> --------------------- >> --template= Specify the template file (UTF-8 encoded). >> Default is >> "/Library/Frameworks/Python.fr >> amework/Versions/2.7/lib >> /python2.7/site-packages/docut >> ils/writers/html5_polygl >> ot/template.txt". >> --stylesheet= >> Comma separated list of stylesheet URLs. Overrides >> previous --stylesheet and --stylesheet-path >> settings. >> --stylesheet-path= >> Comma separated list of stylesheet paths. Relative >> paths are expanded if a matching file is found in >> the >> --stylesheet-dirs. With --link-stylesheet, the >> path is >> rewritten relative to the output HTML file. >> Default: >> "minimal.css,plain.css" >> --embed-stylesheet Embed the stylesheet(s) in the output HTML file. >> The >> stylesheet files must be accessible during >> processing. >> This is the default. >> --link-stylesheet Link to the stylesheet(s) in the output HTML file. >> Default: embed stylesheets. >> --stylesheet-dirs= >> Comma-separated list of directories where >> stylesheets >> are found. Used by --stylesheet-path when >> expanding >> relative path arguments. Default: "['.', >> '/Library/Fra >> meworks/Python.framework/Versi >> ons/2.7/lib/python2.7 >> /site-packages/docutils/writers/html5_polyglot']" >> >> >> >> On 24 August 2017 at 10:57, Lee Griffiths >> wrote: >> >>> >>> Hi >>> >>> (Note: I'm not subscribed to the mailing list) >>> >>> A colleague is having trouble using a script that I wrote which utilises >>> rst2html5.py from the docutils package. The problem is that his version >>> of rst2html5.py doesn't contain the --embed-stylesheet or >>> --stylesheet-path options, which seems really strange to me. >>> >>> His version of rst2html4.py and rst2html.py *do* contain those options, >>> so I've simply changed the script to use those instead. >>> >>> But I would expected all of these tools to have (almost) identical input >>> parameters and simply create different html files. I wouldn't expect a >>> document generation tool written in python to have platform specific >>> behaviour. >>> >>> Is this expectation correct? What causes this difference between >>> platforms? Is this unexpected to anyone else? >>> >>> >>> Thanks, >>> Lee >>> >>> >>> I've attached the --help output for rst2html.py and rst2html5.py for >>> both platforms. Note that for my windows machine I've put the explicit path >>> to the script rather than just executing rst2html.py as my PATH points to >>> the python3 one, and I wanted to keep the differences to a minimum. >>> >>> mac: >>> >>> $rst2html.py --version >>> >>> rst2html.py (Docutils 0.14, Python 2.7.12, on darwin) >>> >>> >>> >>>$ rst2html5.py --version >>> >>> rst2html5.py (Docutils 0.14, Python 2.7.12, on darwin) >>> >>> >>> >>> $which rst2html5.py >>> >>> /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html5.py >>> >>> >>> >>>$ which rst2html.py >>> >>> /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html.py >>> >>> >>> >>> win: >>> >>> $/c/dev/env/python/Python27/Scripts/rst2html5.py --version >>> rst2html5.py (Docutils 0.14, Python 2.7.12, on win32) >>> >>>$ /c/dev/env/python/Python27/Scripts/rst2html.py --version >>> rst2html.py (Docutils 0.14, Python 2.7.12, on win32) >>> >>> >>> >>> >>> >>> >>> >>> ------------------------------------------------------------ >>> ------------------ >>> Check out the vibrant tech community on one of the world's most >>> engaging tech sites, Slashdot.org! http://sdm.link/slashdot >>> _______________________________________________ >>> Docutils-users mailing list >>> Docutils-users@... >>> https://lists.sourceforge.net/lists/listinfo/docutils-users >>> >>> Please use "Reply All" to reply to the list. >>> >>> >> > 
 Re: [Docutils-users] rst2html5.py on mac doesn't support --embed-stylesheet and other options? From: Lee Griffiths - 2017-08-25 08:23:55 Attachments: Message as HTML He simply did pip install docutils. Can you think of anything that would go "wrong" here that would somehow have his version of rst2html5.py being nothing like ours? On 24 August 2017 at 16:50, engelbert gruber wrote: > strange > > > rst2html5.py (Docutils 0.14, Python 2.7.10, on darwin) > > --help > > HTML-Specific Options > --------------------- > --template= Specify the template file (UTF-8 encoded). > Default is > "/Library/Frameworks/Python. > framework/Versions/2.7/lib > /python2.7/site-packages/ > docutils/writers/html5_polygl > ot/template.txt". > --stylesheet= > Comma separated list of stylesheet URLs. Overrides > previous --stylesheet and --stylesheet-path > settings. > --stylesheet-path= > Comma separated list of stylesheet paths. Relative > paths are expanded if a matching file is found in > the > --stylesheet-dirs. With --link-stylesheet, the > path is > rewritten relative to the output HTML file. > Default: > "minimal.css,plain.css" > --embed-stylesheet Embed the stylesheet(s) in the output HTML file. > The > stylesheet files must be accessible during > processing. > This is the default. > --link-stylesheet Link to the stylesheet(s) in the output HTML file. > Default: embed stylesheets. > --stylesheet-dirs= > Comma-separated list of directories where > stylesheets > are found. Used by --stylesheet-path when expanding > relative path arguments. Default: "['.', > '/Library/Fra > meworks/Python.framework/ > Versions/2.7/lib/python2.7 > /site-packages/docutils/writers/html5_polyglot']" > > > > On 24 August 2017 at 10:57, Lee Griffiths > wrote: > >> >> Hi >> >> (Note: I'm not subscribed to the mailing list) >> >> A colleague is having trouble using a script that I wrote which utilises >> rst2html5.py from the docutils package. The problem is that his version >> of rst2html5.py doesn't contain the --embed-stylesheet or >> --stylesheet-path options, which seems really strange to me. >> >> His version of rst2html4.py and rst2html.py *do* contain those options, >> so I've simply changed the script to use those instead. >> >> But I would expected all of these tools to have (almost) identical input >> parameters and simply create different html files. I wouldn't expect a >> document generation tool written in python to have platform specific >> behaviour. >> >> Is this expectation correct? What causes this difference between >> platforms? Is this unexpected to anyone else? >> >> >> Thanks, >> Lee >> >> >> I've attached the --help output for rst2html.py and rst2html5.py for both >> platforms. Note that for my windows machine I've put the explicit path to >> the script rather than just executing rst2html.py as my PATH points to >> the python3 one, and I wanted to keep the differences to a minimum. >> >> mac: >> >> $rst2html.py --version >> >> rst2html.py (Docutils 0.14, Python 2.7.12, on darwin) >> >> >> >>$ rst2html5.py --version >> >> rst2html5.py (Docutils 0.14, Python 2.7.12, on darwin) >> >> >> >> $which rst2html5.py >> >> /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html5.py >> >> >> >>$ which rst2html.py >> >> /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html.py >> >> >> >> win: >> >> $/c/dev/env/python/Python27/Scripts/rst2html5.py --version >> rst2html5.py (Docutils 0.14, Python 2.7.12, on win32) >> >>$ /c/dev/env/python/Python27/Scripts/rst2html.py --version >> rst2html.py (Docutils 0.14, Python 2.7.12, on win32) >> >> >> >> >> >> >> >> ------------------------------------------------------------ >> ------------------ >> Check out the vibrant tech community on one of the world's most >> engaging tech sites, Slashdot.org! http://sdm.link/slashdot >> _______________________________________________ >> Docutils-users mailing list >> Docutils-users@... >> https://lists.sourceforge.net/lists/listinfo/docutils-users >> >> Please use "Reply All" to reply to the list. >> >> > 
 Re: [Docutils-users] rst2html5.py on mac doesn't support --embed-stylesheet and other options? From: engelbert gruber - 2017-08-24 15:50:19 Attachments: Message as HTML strange rst2html5.py (Docutils 0.14, Python 2.7.10, on darwin) --help HTML-Specific Options --------------------- --template= Specify the template file (UTF-8 encoded). Default is "/Library/Frameworks/Python.framework/Versions/2.7/lib /python2.7/site-packages/docutils/writers/html5_polygl ot/template.txt". --stylesheet= Comma separated list of stylesheet URLs. Overrides previous --stylesheet and --stylesheet-path settings. --stylesheet-path= Comma separated list of stylesheet paths. Relative paths are expanded if a matching file is found in the --stylesheet-dirs. With --link-stylesheet, the path is rewritten relative to the output HTML file. Default: "minimal.css,plain.css" --embed-stylesheet Embed the stylesheet(s) in the output HTML file. The stylesheet files must be accessible during processing. This is the default. --link-stylesheet Link to the stylesheet(s) in the output HTML file. Default: embed stylesheets. --stylesheet-dirs= Comma-separated list of directories where stylesheets are found. Used by --stylesheet-path when expanding relative path arguments. Default: "['.', '/Library/Fra meworks/Python.framework/Versions/2.7/lib/python2.7 /site-packages/docutils/writers/html5_polyglot']" On 24 August 2017 at 10:57, Lee Griffiths wrote: > > Hi > > (Note: I'm not subscribed to the mailing list) > > A colleague is having trouble using a script that I wrote which utilises > rst2html5.py from the docutils package. The problem is that his version > of rst2html5.py doesn't contain the --embed-stylesheet or > --stylesheet-path options, which seems really strange to me. > > His version of rst2html4.py and rst2html.py *do* contain those options, so > I've simply changed the script to use those instead. > > But I would expected all of these tools to have (almost) identical input > parameters and simply create different html files. I wouldn't expect a > document generation tool written in python to have platform specific > behaviour. > > Is this expectation correct? What causes this difference between > platforms? Is this unexpected to anyone else? > > > Thanks, > Lee > > > I've attached the --help output for rst2html.py and rst2html5.py for both > platforms. Note that for my windows machine I've put the explicit path to > the script rather than just executing rst2html.py as my PATH points to > the python3 one, and I wanted to keep the differences to a minimum. > > mac: > > $rst2html.py --version > > rst2html.py (Docutils 0.14, Python 2.7.12, on darwin) > > > >$ rst2html5.py --version > > rst2html5.py (Docutils 0.14, Python 2.7.12, on darwin) > > > > $which rst2html5.py > > /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html5.py > > > >$ which rst2html.py > > /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html.py > > > > win: > > $/c/dev/env/python/Python27/Scripts/rst2html5.py --version > rst2html5.py (Docutils 0.14, Python 2.7.12, on win32) > >$ /c/dev/env/python/Python27/Scripts/rst2html.py --version > rst2html.py (Docutils 0.14, Python 2.7.12, on win32) > > > > > > > > ------------------------------------------------------------ > ------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Docutils-users mailing list > Docutils-users@... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. > > 
 [Docutils-users] rst2html5.py on mac doesn't support --embed-stylesheet and other options? From: Lee Griffiths - 2017-08-24 09:19:48 Attachments: rst2html_help_output.7z Message as HTML Hi (Note: I'm not subscribed to the mailing list) A colleague is having trouble using a script that I wrote which utilises rst2html5.py from the docutils package. The problem is that his version of rst2html5.py doesn't contain the --embed-stylesheet or --stylesheet-path options, which seems really strange to me. His version of rst2html4.py and rst2html.py *do* contain those options, so I've simply changed the script to use those instead. But I would expected all of these tools to have (almost) identical input parameters and simply create different html files. I wouldn't expect a document generation tool written in python to have platform specific behaviour. Is this expectation correct? What causes this difference between platforms? Is this unexpected to anyone else? Thanks, Lee I've attached the --help output for rst2html.py and rst2html5.py for both platforms. Note that for my windows machine I've put the explicit path to the script rather than just executing rst2html.py as my PATH points to the python3 one, and I wanted to keep the differences to a minimum. mac: $rst2html.py --version rst2html.py (Docutils 0.14, Python 2.7.12, on darwin)$ rst2html5.py --version rst2html5.py (Docutils 0.14, Python 2.7.12, on darwin) $which rst2html5.py /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html5.py$ which rst2html.py /Library/Frameworks/Python.framework/Versions/2.7/bin/rst2html.py win: $/c/dev/env/python/Python27/Scripts/rst2html5.py --version rst2html5.py (Docutils 0.14, Python 2.7.12, on win32)$ /c/dev/env/python/Python27/Scripts/rst2html.py --version rst2html.py (Docutils 0.14, Python 2.7.12, on win32) 
 [Docutils-users] Introducing devel.tech, a docutils-powered website From: Tony Narlock - 2017-08-18 21:22:40 Attachments: Message as HTML Greetings docutils users, I have recently created a website backed by docutils. It’s called https://devel.tech. - https://devel.tech/tips/n/sNZwQvNh/django-compressor-vs-django-webpack-loader/ (docutils, with Günter’s html5_polyglot Writer) - https://devel.tech/site/updates (docutils) - https://devel.tech/features/django-vs-flask/ (sphinx w/ WebSupport, but I had to fork it https://github.com/develtech/sphinxcontrib-websupport/tree/lean) Docutils provides extensibility, customizability, and great access via python. The site makes full use of the new html5_polyglot Writer as well as various other database-backed roles and writer transformations. My hope is to port sphinx features to work with pure docutils and open source them as extensions. This way more people can leverage the power of pure docutils without pulling in an additional framework. About reStructuredText and why it was picked over markdown: the language is consistent, similar enough to markdown, and allows for flexibility via roles and directives. It was the most powerful, yet nimblest of the two; a great fit for software developers. Best, Tony 
 [Docutils-users] Released 0.14 From: engelbert gruber - 2017-08-03 10:51:20 Attachments: Message as HTML RELEASE-NOTES nothing changed from rc2, except some release documentation and clarification * docutils/docs/ref/docutils.dtd: - Enable validation of Docutils XML documents against the DTD: * docutils/parsers/rst/: - Added functionality: escaped whitespace in URI contexts. - Consistent handling of all whitespace characters in inline markup recognition. (May break documents that relied on some whitespace characters (NBSP, ...) *not* to be recognized as whitespace.) * docutils/utils/smartquotes.py: - Update quote definitions for et, fi, fr, ro, sv, tr, uk. - Add quote definitions for hr, hsb, hu, lv, sh, sl, sr. - Differentiate apostrophe from closing single quote (if possible). - Add command line interface for stand-alone use (requires 2.7). * docutils/writers/_html_base: - Provide default title in metadata. - The MathJax CDN shut down on April 30, 2017. For security reasons, we don't use a third party public installation as default but warn if math-output is set to MathJax without specifying a URL. See math-output_ for details. * docutils/writers/html4css1: - Respect automatic table column sizing. * docutils/writers/latex2e/__init__.py - Handle class arguments for block-level elements by wrapping them in a "DUclass" environment. This replaces the special handling for "epigraph" and "topic" elements. * docutils/writers/odf_odt: - Language option sets ODF document's default language - Image width, scale, ... set image size in generated ODF. * tools/ - New front-end rst2html4.py. cheers 
 Re: [Docutils-users] How stable is reStructuredText format? From: David Goodger - 2017-08-01 13:47:51 On Tue, Aug 1, 2017 at 2:31 AM, crocket wrote: > Will there be breaking changes in reStructuredText in the foreseeable > future? No. Ongoing backward compatibility is of paramount importance in Docutils and the reStructuredText format definition. Any changes made are additions (new constructs which would have failed in the past) or corrections (fixing bugs). Documents from years ago still process properly, using the latest Docutils code. These days changes/additions are infrequent, incremental, and discussed thoroughly on the Docutils-develop mailing list first. David Goodger ; 
 Re: [Docutils-users] How stable is reStructuredText format? From: Ben Finney - 2017-08-01 07:51:28 crocket writes: > Will there be breaking changes in reStructuredText in the foreseeable > future? The reStructuredText *format* was fixed many years ago, and I'm not aware of any proposed newer versions. In fact, I am not aware of any releases of “reStructuredText” in the past ten years. So I'm not sure what changes you're asking about. -- \ “The best ad-libs are rehearsed.” —Graham Kennedy | \ | _o__) | Ben Finney 
 Re: [Docutils-users] How stable is reStructuredText format? From: crocket - 2017-08-01 07:32:06 Attachments: Message as HTML Will there be breaking changes in reStructuredText in the foreseeable future? On Mon, Jul 31, 2017 at 10:27 PM, Roberto Alsina wrote: > On Mon, Jul 31, 2017 at 5:31 AM crocket wrote: > >> If I wrote a document in reStructuredText, how long can I expect it to >> last? >> >> > It depends. > > Will there be a stable, maintained toolchain to process your text in 100 > years? Probably not. > > Will there be a stable, maintained tool to view the HTML or PDF output of > your text in 100 years? Probably yes, because there are enough things that > need to live a long time in those formats. > > Will there be a stable, maintained tool to open text files in 100 years? > Most likely. > > If you change those "100" to lower numbers, each one becomes more likely. > 
 Re: [Docutils-users] Pull dictionary of docinfo fields from a document? From: Tony Narlock - 2017-07-31 21:35:25 Attachments: Message as HTML On July 31, 2017 at 3:03:49 AM, Guenter Milde via Docutils-users ( docutils-users@...) wrote: On 2017-07-30, Tony Narlock wrote: > My intention is to use DocInfo as a way to scape meta information off RST > files to build an index of them. > There is a DocInfo transformer at docinfo.transforms.frontmatter.DocInfo. > Two things: > 1. I don’t want DocInfo fields to show on HTMLWriter Either hide them with CSS or strip with the setting: --strip-elements-with-class= Remove all elements with classes="" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.) Thanks, I gave both those a shot in my initial run. After a bit more digging, I was able to do this by overriding visit_docinfo in the HTMLWriter: def visit_docinfo(self, node): raise nodes.SkipNode > 2. I want to pull a python dictionary of key->value fields from DocInfo. ... > My understanding is DocInfo handles that fields in biblio_nodes, but also > can handle arbitrary field names. ( > http://docutils.sourceforge.net/docs/ref/doctree.html#docinfo). Is that > true? Yes. Check with, e.g. rst2pseudoxml, this gives a nice representation of the doctree. Then you can, e.g. create a function to convert the docinfo sub-tree into the dict. The transforms will give some hints on how to wald around the doctree and collect information. That helped. In my circumstance, I was able to find some permissively licensed code that did a .traverse(nodes.docinfo) to pluck out a dict of the information. Here is the snippet: https://github.com/adieu/mezzanine-cli/blob/c6feeaf/mezzanine_cli/parser.py#L17 License: https://github.com/adieu/mezzanine-cli/blob/c6feeaf/setup.py#L10 Günter ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________ Docutils-users mailing list Docutils-users@... https://lists.sourceforge.net/lists/listinfo/docutils-users Please use "Reply All" to reply to the list. 
 [Docutils-users] Return reStructuredText source content after title, subtitle, and docinfo From: Tony Narlock - 2017-07-31 21:30:59 Attachments: Message as HTML I want to be able to store raw reStructuredText “body content”, including section names after title/subtitle, in a database. At present, I am using publish_doctree to get title, subtitle, and docinfo meta data successfully. So, assuming: ========== Main title ========== Subtitle ======== :Date: 2017-04-04 I want everything from this segment and below Including sections “””””””””””””””””” like this I just want to get this: I want everything from this segment and below Including sections “””””””””””””””””” like this I want the raw reStructuredText to be preserved. 
 Re: [Docutils-users] How stable is reStructuredText format? From: Roberto Alsina - 2017-07-31 13:27:18 Attachments: Message as HTML On Mon, Jul 31, 2017 at 5:31 AM crocket wrote: > If I wrote a document in reStructuredText, how long can I expect it to > last? > > It depends. Will there be a stable, maintained toolchain to process your text in 100 years? Probably not. Will there be a stable, maintained tool to view the HTML or PDF output of your text in 100 years? Probably yes, because there are enough things that need to live a long time in those formats. Will there be a stable, maintained tool to open text files in 100 years? Most likely. If you change those "100" to lower numbers, each one becomes more likely. 
 Re: [Docutils-users] How stable is reStructuredText format? From: Matěj Cepl - 2017-07-31 12:20:24 On 2017-07-31, 08:31 GMT, crocket wrote: > If I wrote a document in reStructuredText, how long can I expect it to last? Longer than the latest version of Microsoft Word and probably longer than with one of various versions of Markdown. Do you still have those Lotus Ami Pro documents? Just next to the Word 2.0 ones? Right. Best, Matěj -- http://matej.ceplovi.cz/blog/, Jabber: mceplceplovi.cz GPG Finger: 3C76 A027 CA45 AD70 98B5 BC1D 7920 5802 880B C9D8 As a rule of thumb, the more qualifiers there are before the name of a country, the more corrupt the rulers. A country called The Socialist People's Democratic Republic of X is probably the last place in the world you'd want to live. -- Paul Graham discussing (not only) Nigerian spam (http://www.paulgraham.com/spam.html) 
 Re: [Docutils-users] How stable is reStructuredText format? From: crocket - 2017-07-31 08:45:57 Attachments: Message as HTML I forgot to send a reply to all recipients. This email is sent to all recipients. I am looking for a lightweight markup language suitable for writing diary and taking notes. Once I write a diary entry, I want to keep it for many decades without modification. If I had to manually modify them after decades, then I would be tempted to treat them as .txt files and not bother to compile them. On Mon, Jul 31, 2017 at 5:35 PM, engelbert gruber < engelbert.gruber@...> wrote: > https://www.openhub.net/p/docutils > > i would say ... rock class > > On 31 July 2017 at 10:31, crocket wrote: > >> If I wrote a document in reStructuredText, how long can I expect it to >> last? >> >> ------------------------------------------------------------ >> ------------------ >> Check out the vibrant tech community on one of the world's most >> engaging tech sites, Slashdot.org! http://sdm.link/slashdot >> _______________________________________________ >> Docutils-users mailing list >> Docutils-users@... >> https://lists.sourceforge.net/lists/listinfo/docutils-users >> >> Please use "Reply All" to reply to the list. >> >> > 
 Re: [Docutils-users] How stable is reStructuredText format? From: engelbert gruber - 2017-07-31 08:35:28 Attachments: Message as HTML https://www.openhub.net/p/docutils i would say ... rock class On 31 July 2017 at 10:31, crocket wrote: > If I wrote a document in reStructuredText, how long can I expect it to > last? > > ------------------------------------------------------------ > ------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Docutils-users mailing list > Docutils-users@... > https://lists.sourceforge.net/lists/listinfo/docutils-users > > Please use "Reply All" to reply to the list. > > 
 [Docutils-users] How stable is reStructuredText format? From: crocket - 2017-07-31 08:31:34 Attachments: Message as HTML If I wrote a document in reStructuredText, how long can I expect it to last? 
 Re: [Docutils-users] Pull dictionary of docinfo fields from a document? From: Guenter Milde - 2017-07-31 08:03:30 On 2017-07-30, Tony Narlock wrote: > My intention is to use DocInfo as a way to scape meta information off RST > files to build an index of them. > There is a DocInfo transformer at docinfo.transforms.frontmatter.DocInfo. > Two things: > 1. I don’t want DocInfo fields to show on HTMLWriter Either hide them with CSS or strip with the setting: --strip-elements-with-class= Remove all elements with classes="" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.) > 2. I want to pull a python dictionary of key->value fields from DocInfo. ... > My understanding is DocInfo handles that fields in biblio_nodes, but also > can handle arbitrary field names. ( > http://docutils.sourceforge.net/docs/ref/doctree.html#docinfo). Is that > true? Yes. Check with, e.g. rst2pseudoxml, this gives a nice representation of the doctree. Then you can, e.g. create a function to convert the docinfo sub-tree into the dict. The transforms will give some hints on how to wald around the doctree and collect information. Günter 
 Re: [Docutils-users] publish_parts and table of contents? From: Tony Narlock - 2017-07-30 18:10:10 Attachments: Message as HTML On July 26, 2017 at 2:03:02 AM, Guenter Milde via Docutils-users ( docutils-users@...) wrote: On 2017-07-25, Tony Narlock wrote: > What if the user doesn’t want to publish CSS from the tree? You can select the used CSS stylsheet(s) as well as toggle between inclusion and referencing them via Docutils settings. For programmatic use, "settings_override" is your friend. See "config.html" and the documentation the publish_* functions for descriptions and, e.g., the functional tests for usage examples. > Even if using > publish_doctree, I prefer the equivalent to publish_parts fragment and > html_body, usually. > Here is what I did: ... > Is the equivalent of this attainable a simpler way? Is something like this > worth considering as a patch? I don't know. You may file an enhancement ticket. Considering that. Also the addition of "contents" as a part for the HTML writer seems like a valid enhancement request. (But mind that we don't have many ressources to really work on it.) The ToC is being used on a production website right now, I plan on making a post about how the site uses docutils. I’m trying to get myself into gear on docutils internals so I can help now and then. Günter ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________ Docutils-users mailing list Docutils-users@... https://lists.sourceforge.net/lists/listinfo/docutils-users Please use "Reply All" to reply to the list. `
41 messages has been excluded from this view by a project administrator.

Showing results of 7793

1 2 3 .. 312 > >> (Page 1 of 312)