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: 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: 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: 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: 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 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: 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 17:29:31
|
On 20/02/2022 16:29, Martin Koutecký wrote: > You're missing a space: > .. class:: borderless Thanks. But this is where proportional fonts really mess up. But even with fixed-width, what space where?! As far as I can tell, I've got exactly what you wrote: dot dot space class colon colon space borderless and it's not working. stick a space after class and it has no effect. I just don't know what I'm doing, and nothing works. 2.2 Structural Terms: ..................... .. 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. Cheers, Wol > > M. > > Dne ne 20. 2. 2022 16:44 uživatel Wols Lists <ant...@yo... > <mailto: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> > > > > <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> > <https://david.goodger.org <https://david.goodger.org>>> > > > > > > On Sat, Feb 19, 2022 at 8:00 PM Wol <ant...@yo... > <mailto:ant...@yo...> > > <mailto: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...> > > <mailto:Doc...@li... > <mailto:Doc...@li...>> > > https://lists.sourceforge.net/lists/listinfo/docutils-users > <https://lists.sourceforge.net/lists/listinfo/docutils-users> > > <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... > <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: Guenter M. <mi...@us...> - 2022-02-20 17:34:30
|
On 2022-02-20, Wols Lists wrote: ... >>> This is oh so simple with tabs or fixed width fonts - why do so many >>> modern systems find it almost impossible! ... > What I'm *transcribing* is a document where they DID force columns with > spaces and tabs :-) You can, of course just do it this way: write your document with fixed-width font. If you want this as part of a reStructuredText document (i.e. documentation done with Sphinx or Docutils), you must use "literal blocks":: Here the spacing is preserved. You may also include a file "as is" with .. include:: my-tabbed-document.txt :literal: But I recommend using a simple table, a field-list or a description list, IMV this looks and "behaves" better in a browser or on paper. Günter |
From: Wol <ant...@yo...> - 2022-02-21 20:02:55
|
On 20/02/2022 17:34, Guenter Milde via Docutils-users wrote: > On 2022-02-20, Wols Lists wrote: > > ... > >>>> This is oh so simple with tabs or fixed width fonts - why do so many >>>> modern systems find it almost impossible! > > ... > >> What I'm *transcribing* is a document where they DID force columns with >> spaces and tabs :-) > > You can, of course just do it this way: write your document with fixed-width > font. > > If you want this as part of a reStructuredText document (i.e. documentation > done with Sphinx or Docutils), you must use "literal blocks":: > > Here the > spacing is preserved. > > You may also include a file "as is" with > > .. include:: my-tabbed-document.txt > :literal: > > But I recommend using a simple table, a field-list or a description list, > IMV this looks and "behaves" better in a browser or on paper. > Well, I think I'm giving up on most of this, at least until I can put this up where someone can actually debug the mess. The reason I want to get rid of the grid lines is they basically screw up the display. But ":class: borderless" just seems to be a total waste of time! Sorry, I do appreciate all the help, but it's just not doing anything! So what is the correct syntax for declaring a literal block? And here's hoping it actually does what it claims! Sorry, but I'm really getting totally jaded at getting absolutely no-where! Here's hoping I won't be hassling you with more problems trying to get literal to work! Cheers, Wol |
From: Guenter M. <mi...@us...> - 2022-02-20 18:30:26
|
On 2022-02-20, Wols Lists wrote: ... > 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. In order to get it working this way, you need to *nest* the table in the directive (i.e. indent it to the same amount as the second line): .. table:: :class: borderless ============== =================================================== Item-Id - A character string (maximum 48 characters) which uniquely identifies an item within a file. ... ... ... ============== =================================================== In Docutils, you can easily avoid the indenting with a "prefix" class directive: .. class:: borderless ============== =================================================== Item-Id - A character string (maximum 48 characters) which uniquely identifies an item within a file. ... ... ... ============== =================================================== In Sphinx, the "class" directive is used for other purposes by default and must be activated in the setup.py config file. You can also set a default class for all tables in a document with the table_style configuration setting. https://docutils.sourceforge.io/docs/user/config.html#table-style This should work in Docutils and Sphinx. Instead of a table, you may use lists: A definition list https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#definition-lists Item-Id - A character string (maximum 48 characters) which uniquely identifies an item within a file. ... ... ... or a field list https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#field-lists :Item-Id: A character string (maximum 48 characters) which uniquely identifies an item within a file. ... :...: ... The layout/formatting of the lists can be customized in a stylesheet. Hope this helps a bit. Güner |
From: Wol <ant...@yo...> - 2022-02-20 20:39:33
|
On 20/02/2022 18:30, Guenter Milde via Docutils-users wrote: > On 2022-02-20, Wols Lists wrote: > > ... > >> 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. > In order to get it working this way, you need to*nest* the table in the > directive (i.e. indent it to the same amount as the second line): > > .. table:: > :class: borderless > > ============== =================================================== > Item-Id - A character string (maximum 48 characters) which > uniquely identifies an item within a file. /home/anthony/gitstuff/ScarletDME/docs/source/SMA/SMA301.rst:80: WARNING: Error in "table" directive: invalid option block. .. table:: :class: borderless =========== ========================================================= Item-Id - A character string (maximum 48 characters) which > In Sphinx, the "class" directive is used for other purposes by default > and must be activated in the setup.py config file. ??? What setup file? Where? How? Is this the cause of my error above? Is it the conf.py file? Cheers, Wol |
From: Guenter M. <mi...@us...> - 2022-02-21 13:57:34
|
On 2022-02-20, Wol wrote: > On 20/02/2022 18:30, Guenter Milde via Docutils-users wrote: >> On 2022-02-20, Wols Lists wrote: >> ... >>> 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. >> In order to get it working this way, you need to*nest* the table in the >> directive (i.e. indent it to the same amount as the second line): >> .. table:: >> :class: borderless >> ============== =================================================== >> Item-Id - A character string (maximum 48 characters) which >> uniquely identifies an item within a file. > /home/anthony/gitstuff/ScarletDME/docs/source/SMA/SMA301.rst:80: > WARNING: Error in "table" directive: > invalid option block. > .. table:: > :class: borderless > =========== ========================================================= > Item-Id - A character string (maximum 48 characters) which You are missing the empty line between the option block and the table! > > In Sphinx, the "class" directive is used for other purposes by default > > and must be activated in the setup.py config file. > ??? What setup file? Where? How? Is this the cause of my error above? Is > it the conf.py file? No. See https://docutils.sourceforge.io/docs/user/config.html#configuration-files Ask on the Sphinx list where Sphinx expects a project-specific Docutils configuration file. Günter |