restructuredtext

Is there a way to input a newline into a table cell? For example, say I have a table like this: +----------+----------+----------+ | Header 1 | Header 2 | Header 3 | +==========+==========+==========+ | Item 1 | | | | Item 2 | | | +----------+----------+----------+ I want the above to create a table with two rows, three columns, and the second row, first column to display Item 1 and Item 2 on separate lines. I have tried the line blocks syntax |, but it doesn't work inside a table cell. I can use list syntax, but I don't want bullet points to appear. First of all I think your table syntax is

I try to insert a link into bold text in reStructuredText but failed. This is my rst source: **Lorem ipsum dolor sit amet, `consectetur <http://www.example.com>`_ adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.** but I got: <strong>Lorem ipsum dolor sit amet, `consectetur <http://www.example.com>`_ adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</strong> I want to get this: <strong>Lorem ipsum dolor sit amet, <a href="http://www.example.com">consectetur</a> adipisicing elit, sed do eiusmod tempor incididunt ut labore et

In Sphinx, if I have the following heading declaration: .. _somestuff: ``this is code``, this is not! ============================== It renders, like this: this is code , this is not! Which is good, but, if I use the reference, e.g: Have a look at :ref:`somestuff` It loses the code formatting and renders like: Have a look at this is code, this is not! instead of: Have a look at this is code , this is not! Is it possible to retain the code formatting in the reference? And how would I go about it? If you have a look at :ref: documentation in its official web site about inline markups: :ref: To

Example: foo is a tool used to do foo. Download_ .. _Download: http://example.com/foo blah blah blah (omit a lot of paragraphs) bar is another tool to do bar. Download_ .. _Download: http://example.com/bar Since Download points to different urls, docutilus gives this error report: Duplicate target name, cannot be used as a unique reference: "Download". While in markdown, I can specify different id for this two Download : [Download][download-foo] [download-foo]: http://example.com/foo [Download][download-bar] [download-bar]: http://example.com/bar How can I do similar things in reStructuredText

This question already has answers here : How to specify multiple return types using type-hints (2 answers) In a Python docstring how should one document the :rtype: for a function that can return multiple possible data types? For example, if a function can return defaultdict OR dict OR list , based on the functions parameters, how do you document this? Code example: from collections import defaultdict def read_state(state_file, state_file_type='defaultdict'): """Deserialize state file or create empty state and return it. :param state_file: The path and file name of state file to read. :type