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 (25) Mar Apr May Jun Jul Aug Sep Oct Nov Dec
S M T W T F S

1
(3)
2
(3)
3
(1)
4
(6)
5
(4)
6
(9)
7
(17)
8
(16)
9
(11)
10
(23)
11
(8)
12
(8)
13
(13)
14
(4)
15
(1)
16
(2)
17
(5)
18
(2)
19
(2)
20
(2)
21
(3)
22
(5)
23

24

25

26

27
(1)
28
(3)
29

30

Showing results of 152

<< < 1 2 3 4 5 .. 7 > >> (Page 3 of 7)
 Re: [Docutils-users] custom directive From: Aahz - 2010-09-12 04:32:10 [I'm not paying much attention to this thread because I Don't Care, but the following needs an out-of-context response IMO] On Thu, Sep 09, 2010, Alan G Isaac wrote: > > Something usable *now* is better than waiting for perfection, [...] >From "import this": Now is better than never. Although never is often better than *right* now. -- Aahz (aahz@...) <*> http://www.pythoncraft.com/ [on old computer technologies and programmers] "Fancy tail fins on a brand new '59 Cadillac didn't mean throwing out a whole generation of mechanics who started with model As." --Andrew Dalke 
 Re: [Docutils-users] reST -> slides: first thoughts From: Guenter Milde - 2010-09-11 23:39:18 On 2010-09-10, Stefan Merten wrote: > Hi G=FCnter and all! > 3 days ago Guenter Milde wrote: >> For improved flexibility > Flexibility is a point. But I don't understood why it is needed. I suggested the de-coupling of section structure and slide structure because I have a background in the "seminar" LaTeX class where these are implemented completely orthogonal. IMO, there are use cases for: a) slides without heading/title b) more than one (sub) sections on one slide which cannot be achieved with Alans: "use the lowest section level" convention. >> and compatibility with other writers,=20 > I support that goal. But do classes not supported by other writers > really help this goal? My first feeling is scepticism. For class arguments, "not supported" means "ignored". Hence, class arguments are IMO the best way to mark features that have only a meaning to slide-writers. Ignoring is the right way to handle them in non-slide writers. ... >> Objects can be "decorated" with special class arguments: >> newslide >> place this object on a new slide > Well, I like this coupling because it's intuitive. > May be you can add transitions to the list of supported structures to > end up as headerless slides. If a transition "ends up" as headerless slide, this would be an empty slide, because a transition has no content. But it might be used to start a new slide :-) >> newoverlay >> place this object on a new "overlay" (which gives the appearance of >> incremental exposure of a given slide).=20=20 > In my previous mail I proposed a syntax for a pause. My main point is > that such a syntax must be tiny and inline so it doesn't disturb you > when you are reading the source. Are "pauses" really used in-line (inside paragraphs, say)? > Classes do not have these features. Roles may but roles are for > regions whereas here you have a point. Substitutions are the only > standard reST facility coming to my mind which seem fit here. Substitutions are not seen by the writer. The role content (say :pause:*) can be ignored by the writer/style. You can define a substitution in your document if this is still too much "visual clutter". With the latex2e writer, you can already convert a :pause: role into a \pause command (ignoring the content) by defining a \DUrolepause macro in the preamble or style sheet. >> * Slide source remains a valid reStructuredText document without >> additions to the rst syntax. > I agree that needs to be a top goal. >> * For simpler input, slide writers might use a config setting / command >> line argument > *If* we really need the flexibility here then I'd prefer a convention > over configuration approach. By default the sectioning is the lead but > you may use special classes like you suggested to ignore the section > structure. Than make your favourite setting the default. Günter 
 Re: [Docutils-users] latex writer request: two part table From: Guenter Milde - 2010-09-11 23:08:13 On 2010-09-10, Alan G Isaac wrote: > Can the LaTeX writer make the two-part table below look good? Not any time soon, I'm afraid. You might file a bugreport. Günter 
 Re: [Docutils-users] rst2beamer From: Alan G Isaac - 2010-09-11 20:37:51 On 9/11/2010 11:28 AM, Ryan Krauss wrote: > not sure I care about Tufte's opinion on presentations Probably anyone who cares about presentations should *care*, even if they end up disagreeing. He's good. Alan PS http://www.edwardtufte.com/bboard/q-and-a-fetch-msg?msg_id=0001yB&topic_id=1 
 Re: [Docutils-users] reST -> slides: first thoughts From: Alan G Isaac - 2010-09-11 20:31:16 > Günter wrote: >> I propose a class argument based approach to slides with >> reStructuredText On 9/10/2010 3:11 PM, Stefan Merten wrote: > The problem with this approach for me is: It introduces a lot of > degrees of freedom which is useful re flexibility but not useful re > easyness and compatibility. The lots of degrees of freedom end up in > difficult problems you already discussed in this thread. I think at the most basic level, there is not a conflict. The idea was that objects that should generate a slide should be decorated with a slide class. Naturally we want to be able to write documents for slides where sub(sub)sections are automatically used as slides. For this, we just need to be able to specify as an option what level of sectioning determines slides. This can be implemented by decorating every section at the appropriate header level. (I.e., with a user option.) Then only additional objects for which slides are wanted need be decorated by hand. If there are none, then nothing need be added by hand. I am not resolving key issues, like what happens if a section and its subsection are both labeled as slides. Decisions will have to be made on this. (I vote: a slide class on an object always means start a *new* slide.) Cheers, Alan 
 Re: [Docutils-users] rst2beamer From: Alan G Isaac - 2010-09-11 19:53:28 On 9/11/2010 3:46 PM, Alan G Isaac wrote: > Step 5: > Change to your new check out, and create a directory, and put your code there. > Once you've got everything in place, add the directory to svn. E.g., just above your newdirectory > svn add mynewdirectory > should add the directory and all it contains. Step 6: svn commit -m "Moving Ryan and Paul-Michael's code to the sandbox." 
 Re: [Docutils-users] rst2beamer From: Alan G Isaac - 2010-09-11 19:46:50 On 9/11/2010 11:31 AM, Ryan Krauss wrote: > The sandbox readme doesn't have an SVN for idiots guide to creating > a directory and uploading to it. Can someone help me get going > please? Hi Ryan, This is my understanding (from memory): Stefan, can you please comment on step 3? hth, Alan Step 1: sign up for a a berlios account http://developer.berlios.de/account/register.php Step 2: post your user name on this list, and David (?) will register you as a docutils developer. Step 3: Decide where your code will reside. Right now there is an rst2beamer directory. It might (?) make sense for you to have an rst2beamer subdirectory in this. (Stefan, can you please suggest what to do with your code, and whether sharing this directory is a good idea.) Let's assume that this is what you choose to do, for step 4. Step 4: Check out the directory that will hold your code (or the whole sandbox if you prefer). Something like svn checkout https://rkrauss@.../svnroot/repos/docutils/trunk/sandbox/rst2beamer rst2beamer Step 5: Change to your new check out, and create a directory, and put your code there. Once you've got everything in place, add the directory to svn. E.g., just above your newdirectory svn add mynewdirectory should add the directory and all it contains. 
 Re: [Docutils-users] rst2beamer From: Ryan Krauss - 2010-09-11 15:31:21 The sandbox readme doesn't have an SVN for idiots guide to creating a directory and uploading to it. Can someone help me get going please? Ryan On Sat, Sep 11, 2010 at 10:28 AM, Ryan Krauss wrote: > I don't care about putting it in the sandbox as long as it is easy for > me to do.  I need to read up on it. > > I also know almost nothing about svn.  I am hoping that git-svn solves > that for me. > > I am also not sure I care about Tufte's opinion on presentations :)- > I want my students thinking about my current point and not jumping > ahead. > > Ryan > > On Fri, Sep 10, 2010 at 4:25 PM, Alan G Isaac wrote: >> On 9/10/2010 3:23 PM, Stefan Merten wrote: >>> I'm a bit confused about the author of the alternative rst2beamer >>> implementation. Roberto? Ryan? >> >> The authors are Ryan and Paul-Michael (who have not yet expressed an >> opinion about moving their project to the sandbox). >> >> Cheers, >> Alan >> >> >> ------------------------------------------------------------------------------ >> Start uncovering the many advantages of virtual appliances >> and start using them to simplify application deployment and >> accelerate your shift to cloud computing >> http://p.sf.net/sfu/novell-sfdev2dev >> _______________________________________________ >> 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] rst2beamer From: Ryan Krauss - 2010-09-11 15:28:12 I don't care about putting it in the sandbox as long as it is easy for me to do. I need to read up on it. I also know almost nothing about svn. I am hoping that git-svn solves that for me. I am also not sure I care about Tufte's opinion on presentations :)- I want my students thinking about my current point and not jumping ahead. Ryan On Fri, Sep 10, 2010 at 4:25 PM, Alan G Isaac wrote: > On 9/10/2010 3:23 PM, Stefan Merten wrote: >> I'm a bit confused about the author of the alternative rst2beamer >> implementation. Roberto? Ryan? > > The authors are Ryan and Paul-Michael (who have not yet expressed an > opinion about moving their project to the sandbox). > > Cheers, > Alan > > > ------------------------------------------------------------------------------ > Start uncovering the many advantages of virtual appliances > and start using them to simplify application deployment and > accelerate your shift to cloud computing > http://p.sf.net/sfu/novell-sfdev2dev > _______________________________________________ > 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] rst2beamer: problem with the fragile option From: Alan G Isaac - 2010-09-10 23:44:45 Here's another reason not to set the fragile option by default: 12.9 Verbatim and Fragile Text If you wish to use a {verbatim} environment in a frame, you have to add the option [fragile] to the {frame} environment. In this case, you really have to use the {frame} environment (not the \frame command) and the \end{frame} must be alone on a single line. Using this option will cause the frame contents to be written to an external file and then read back. See the description of the {frame} environment for more details. An example implication: suppose you put in a slide .. raw:: latex $a = b$ Then rst2beamer will write a document that won't compile (because the fragile option is set, but \end{frame} will not be on its own line. So the request is: please let us choose which frames are fragile but setting a class (with the class directive). Cheers, Alan Isaac 
 Re: [Docutils-users] rst2beamer From: Alan G Isaac - 2010-09-10 21:25:42 On 9/10/2010 3:23 PM, Stefan Merten wrote: > I'm a bit confused about the author of the alternative rst2beamer > implementation. Roberto? Ryan? The authors are Ryan and Paul-Michael (who have not yet expressed an opinion about moving their project to the sandbox). Cheers, Alan 
 Re: [Docutils-users] reST -> slides: first thoughts From: Stefan Merten - 2010-09-10 19:58:13 Attachments: application/pgp-signature Hi Alan and all! This is a very useful initiative! I have a couple of ideas. See below. 4 days ago Alan G Isaac wrote: > A Need > ====== > > One definite need is a test document that all slide writers > should be able to handle. Yes! > Some Problems > ============= > > 1. There is no settled reST slide format, so writers > do not offer consistent handling I could imagine having a family of writers all producing slides but in different formats. May be we could even have special directives or roles for this family? > 2. The following are desirable but potential conflict: > > - title > - optional subtitle > - optional sections > - optional subsections > - implementing slides with standard reST sectioning > > - easier to write > - looks a lot better as text Why do you think they are potential conflicts? > Solution to Problem 2 > ===================== > > A possible solution within current reST syntax is > for the lowest section level to always be treated > as slides. This means that if you want sections and > subsections, the first slides must be in a section > and in a subsection. (rst2beamer takes this approach; > rst2s5 does not. It seems to be the right approach.) I think we need a concept for this topic. Some thoughts. There are two general types of presentations: Flat and hierarchical ones. Some formats such as PowerPoint support only flat slides. Other formats such as beamer support hierarchical slides. Subsectioning is certainly a point for the latter. The question already discussed in this thread is how hierarchical slides are mapped to a presentation. What seems to be clear is that there is a "leaf level" which contains the real slides. The question is how to handle the higher sections. IMHO there are these options: * Use higher sections for explicit navigation In beamer there are lots of styles which contain explicit navigation. This would be certainly an option but only for those formats supporting explicit navigation. * Generate intermediate "agenda" slides from higher sections Another common pattern is to have an agenda slide and between higher sections insert a special agenda slide showing the current location in the presentation. This should be an option for all writers. * Generate a structure title When I used MagicPoint for my presentations I used a structured title on each slide as navigation hint. I had a top level element which usually rendered in a small font and the title of the slide in bigger font. This should be an option for most if not all writers. I'd find it very useful if there would be an option common to all slide writers which decides which variant to take. Here are some more thoughts. * Agenda slides by .. contents:: A .. contents:: directive should be transformed to an agenda slide. As a variant of the agenda slides idea mentioned above this could be done for every .. contents:: directive. * Supported reST features It would be useful if the reST features which should be supported are defined. For instance support for inline markup and images. * Rendering as normal document by standard writers A reST document meant as a slide set should render all content normally by the standard writers. * Support for notes Some formats allow for notes. There should be some syntax to markup notes as such and render them as notes in formats supporting them. The easiest way would be to define special classes for this purpose. * Support for pauses Some formats allow for pauses in the presentation. In particular in beamer slides you can set pauses as you like. There should be some way to write pauses. I'm using. :: .. |p| raw:: latex \pause The syntax for this should be minimal (like in the substitution above) and should be ignored by standard writers. BTW: I remember vaguely that there was a solution for S5 using standard role. I disliked this because a pause is at a certain *point* whereas a role marks a *region*. The obvious question is: Is the pause done at the beginning or the end of the region? > rst2beamer Improvement Suggestions > ================================== I didn't check for the rst2beamer implementation but IMHO it should subclass the / an LaTeX writer to inherit all the benefits from it. > PowerPoint Slides > ================= > > Solution: rst2outline http://docutils.sourceforge.net/sandbox/rst2outline/ > > :: > > rst2outline slides.rst slides.txt > powerpnt.exe slides.txt There is another option in PowerPoint where you can insert slides from such an outline. This is a great way to include slides into a given format template. May be you can mention this? Grüße Stefan 
 Re: [Docutils-users] reST -> slides: first thoughts From: Stefan Merten - 2010-09-10 19:58:12 Attachments: application/pgp-signature Hi Günter and all! 3 days ago Guenter Milde wrote: > For improved flexibility Flexibility is a point. But I don't understood why it is needed. > and compatibility with other writers, I support that goal. But do classes not supported by other writers really help this goal? My first feeling is scepticism. > I propose a > > class argument based approach to slides with reStructuredText > ------------------------------------------------------------- The problem with this approach for me is: It introduces a lot of degrees of freedom which is useful re flexibility but not useful re easyness and compatibility. The lots of degrees of freedom end up in difficult problems you already discussed in this thread. One thing I really love reStructuredText for that easy things are easy and intuitive to accomplish (most of the syntax) and complicated things are possible (directives). I'd welcome if this approach could be kept when thinking about conventions for slides. > Objects can be "decorated" with special class arguments: > > newslide > place this object on a new slide Well, I like this coupling because it's intuitive. May be you can add transitions to the list of supported structures to end up as headerless slides. > newoverlay > place this object on a new "overlay" (which gives the appearance of > incremental exposure of a given slide). In my previous mail I proposed a syntax for a pause. My main point is that such a syntax must be tiny and inline so it doesn't disturb you when you are reading the source. Classes do not have these features. Roles may but roles are for regions whereas here you have a point. Substitutions are the only standard reST facility coming to my mind which seem fit here. > notesonly > do not place this object on a slide (i.e. ignore when producing slides) > (Can be achieved without changes to Docutils via the > strip-elements-with-class setting). That is something which I consider useful. An alternative would be a special directive for the slide family of writers but then there is a problem with compatibility. > slidesonly > do not place this object in the notes (i.e. when generating > standard HTML/LaTeX/PDF output for the handout or notes). > (Can be achieved without changes to Docutils via the > strip-elements-with-class setting). Could make sense though I don't see the use case for this class. > Advantages: > > * De-coupling of slide structure and sectioning. Well, personally I find this coupling useful and intuitive. Thus I find a de-coupling counter-intuitive. > * Slide source remains a valid reStructuredText document without > additions to the rst syntax. I agree that needs to be a top goal. > * For simpler input, slide writers might use a config setting / command > line argument [...] > say :: > > --slide-section-level=N > Add "newslide" to all section headings of level N. > > which, with N==1, would result in the current rst2s5 behaviour. *If* we really need the flexibility here then I'd prefer a convention over configuration approach. By default the sectioning is the lead but you may use special classes like you suggested to ignore the section structure. Grüße Stefan 
 [Docutils-users] State of rst2beamer implementations (was: Re: reST -> slides: first thoughts) From: Stefan Merten - 2010-09-10 19:58:12 Attachments: application/pgp-signature Hi Alan and Roberto! 3 days ago Alan G Isaac wrote: >>> PDF Slides: rst2beamer > > On 9/7/2010 6:19 AM, Guenter Milde wrote: >> Keep in mind that there are at least two independent implementations >> under the same name. > > Aha! So the version in the sandbox is unrelated to the version on PyPI? Yes. This was an independent approach and probably no approach knew of the other. The general idea of the sandbox approach is to use the LaTeX writer as the super class making many things easy to solve. However, this broke when the super class changed massively :-( . I'd vote for including Roberto's (?) implementation to the sandbox. Grüße Stefan 
 Re: [Docutils-users] rst2beamer From: Stefan Merten - 2010-09-10 19:58:11 Attachments: application/pgp-signature Hi Günter! 2 days ago Guenter Milde wrote: > On 2010-09-06, Stefan Merten wrote: >> Yesterday Alan G Isaac wrote: > >>> I'm finding the rst2beamer situation a bit confusing. > >> It is :-( . > > I corrected the author in rst2beamer.py in the sandbox. Thanks. >> The version in the sandbox is indeed by me. It used the LaTeX >> implementation as a super class. After I wrote rst2beamer the LaTeX >> implementation has been changed massively and so with current versions >> of docutils rst2beamer doesn't work any more :-( . This certainly >> needs fixing... > > Do you plan to maintain/fix the sandbox code or is this an "orphaned" > project? Well, I'm not keen to develop this further if there is an alternative - which seems to be the case. However, this alternative should be moved to the sandbox then. > I cannot put much effort in it but I can help with adaption to the > current state of the latex writer. From the discussions here I reckon the alternative implementation is more useful and thus I'd rather vote for merging the implementations - or rather the ideas. The central idea of my version is the subclassing of the latex writer. I'm a bit confused about the author of the alternative rst2beamer implementation. Roberto? Ryan? In any case: Does this make sense to you? Grüße Stefan 
 Re: [Docutils-users] rst2pdf questions From: Alan G Isaac - 2010-09-10 18:43:33 On 9/9/2010 9:24 PM, Roberto Alsina wrote: > if you use -s a4-landscape you get ... a4 landscape Thanks! Alan 
 Re: [Docutils-users] Custom header/footers not working for rst2odt From: Bryan Vicknair - 2010-09-10 16:10:13 Dave Kuhlman rexx.com> writes: > I've made a fix for the problem with --custom-odt-header and > --custom-odt-footer in odf-odt writer. And I've checked it in to the SVN > repository. > > Byran, thanks for helping me track this down. I'll send you the update in a > separate email, in case you do not get Docutils from the SVN repository. > > - Dave That patch seems to have fixed it. Thanks for all the help and quick turnaround Dave. Bryan 
 [Docutils-users] latex writer request: two part table From: Alan G Isaac - 2010-09-10 15:48:23 Can the LaTeX writer make the two-part table below look good? (Here's the image: http://www.federalreserve.gov/aboutthefed/bios/board/bernanke_ben.jpg) Currently the image alignment messes things up. I believe that in situations like this, the top of the image and the list should each be aligned with the top of the cell. (Nothing else looks good.) Thanks, Alan Isaac .. list-table:: * + .. image:: bernanke_ben.jpg + PhD from MIT 1979 Chair, Princeton Econ Dpt 1996 - 2002 Member, Fed BoG 2002 - 2005 Chair, CEA June 2005 - Jan 2006 Chair, BoG of Fed Feb 2006 - present 
 Re: [Docutils-users] 2 part table From: Alan G Isaac - 2010-09-10 14:22:53 >> On 9/9/2010 9:49 PM, David Goodger wrote: >>> Grid tables are a pain to use, but possible. > On Fri, Sep 10, 2010 at 09:59, Alan G Isaac wrote: >> It might be useful to mention grid tables in the >> table documentation here: >> http://docutils.sourceforge.net/docs/ref/rst/directives.html#tables >> (Otherwise, they can easily be overlooked.) On 9/10/2010 10:06 AM, David Goodger wrote: > I disagree. That's the documentation for directives, not general reST > syntax (grid table syntax is not a directive). Fully documented here: > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables I only meant adding something like the following: Grid tables and simple tables can be associated with a title by using the "table" directive. But whatever. Alan 
 Re: [Docutils-users] 2 part table From: David Goodger - 2010-09-10 14:06:31 On Fri, Sep 10, 2010 at 09:59, Alan G Isaac wrote: > On 9/9/2010 9:49 PM, David Goodger wrote: >> Grid tables are a pain to use, but possible. > > It might be useful to mention grid tables in the > table documentation here: > http://docutils.sourceforge.net/docs/ref/rst/directives.html#tables > (Otherwise, they can easily be overlooked.) I disagree. That's the documentation for directives, not general reST syntax (grid table syntax is not a directive). Fully documented here: http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables -- David Goodger ; 
 Re: [Docutils-users] 2 part table From: Alan G Isaac - 2010-09-10 13:59:28 On 9/9/2010 9:49 PM, David Goodger wrote: > Grid tables are a pain to use, but possible. It might be useful to mention grid tables in the table documentation here: http://docutils.sourceforge.net/docs/ref/rst/directives.html#tables (Otherwise, they can easily be overlooked.) Alan 
 Re: [Docutils-users] 2 part table From: Alan G Isaac - 2010-09-10 13:40:20 On 9/9/2010 9:49 PM, David Goodger wrote: > Simple tables won't work: "Simple tables allow multi-line rows (in > all but the first column)" (reST markup spec). Ah, that's the clue. If I put the image in the *first* column (and don't need any options) I can use a simple table. Unfortunately, the LaTeX writer does not do anything to place the image nicely in its cell, and the LaTeX default behavior produces a bad outcome. But in principle, this can work (and does work nicely for HTML writers, and pretty nice for rst2pdf as well). The list table you suggested also works (but of course has the same LaTeX display difficulties). Thanks! Alan 
 Re: [Docutils-users] reST math From: Roberto Alsina - 2010-09-10 12:45:49 On Friday 10 September 2010 09:40:53 Alan G Isaac wrote: > Note that rst2pdf already implements a math directive, > using iiuc the mathtext engine from Matplotlib. Yes. It's not very polished, but it mostly works. 
 Re: [Docutils-users] reST math From: Alan G Isaac - 2010-09-10 12:41:07 On 9/10/2010 3:26 AM, Guenter Milde wrote: > Initial version: > * :math: role and .. math:: directive > * content written in the syntax of TeX math mode, e.g.:: > f(x) = \sin2(x) + \beta > * latex2e writer wraps it in  or  > * html writer(s) generate or
with class='math' > content is treated like normal text (escaping special HTML chars) > * odt writer ????? > * PDF writer (reportlab) should be fine (?). This seems mostly good to me. I would just add: - do it by moving Jens's work (known to work quite well) into the core. This already handles multi-line equations. - make sure all writer can just present the math as (parsed) literal text, as transition. - E.g., the odt writer could start this way. (Actually OO allows LaTeX input, so there may be a simple solution.) Note that rst2pdf already implements a math directive, using iiuc the mathtext engine from Matplotlib. Alan 
 [Docutils-users] reST math (was: custom directive) From: Guenter Milde - 2010-09-10 07:26:33 On 2010-09-10, Alan G Isaac wrote: > On 9/9/2010 8:03 AM, Guenter Milde wrote: >> For math, the problem remains that LaTeX would expect the raw content >> (i.e. \sin(x) without escaped \textbackslash), while HTML would e.g. >> choke on< and>. This also prevents the use of a "literal" wrapper. > How did Jens deal with this? Look at his sources and/or documentation :-) > Something usable *now* is better than waiting for > perfection, especially if from the user perspective > there is just a math directive that produces better and > better output as docutils is slowly improved. Agreed. However: * There should be a general agreement on the direction to go, * There should be a general agreement on the way to do it. (David Goodger suggested a math-branch, I shy away from the overhead involved in setting up a branch and later merging.) * Someone has to do it. > If the design is uncertain, just label it "experimental" in the docs, > and indicate it is subject to change. As I recall it, David blessed > using LaTeX for the content of the math directive, so LaTeX writers > will surely just wrap this content. Proposal -------- see also http://docutils.sourceforge.net/docs/dev/todo.html (search for 'math'). Initial version: * :math: role and .. math:: directive * content written in the syntax of TeX math mode, e.g.:: f(x) = \sin^2(x) + \beta * latex2e writer wraps it in  or  * html writer(s) generate or
with class='math' content is treated like normal text (escaping special HTML chars) * odt writer ????? * PDF writer (reportlab) should be fine (?). Improvements that can be incrementally implemented: * accept Unicode input:: f(x) = \sin²(x) + β (conversion to TeX syntax in the latex2e writer). * options for multi-line equation environments * TeX -> MathML converter as a transform that can be called by "interested" writers (based on the latex-math sandbox project). * Alternative format converters: TeX -> SVG (via dvisvg) TeX -> PNG (existing add-on for Sphinx) TeX -> MathJax (existing add-on for Sphinx) TeX -> Unicode * Alternative input formats (see http://docutils.sourceforge.net/docs/dev/todo.html) 

Showing results of 152

<< < 1 2 3 4 5 .. 7 > >> (Page 3 of 7)