restructuredtext - how to document a single space character within a string in reST/Sphinx? -

-

i've gotten lost in edge case of sorts. i'm working on conversion of old plaintext documentation rest/sphinx format, intent of outputting few formats (including html , text) there. of documented functions dealing bitstrings, , common case within these sentence following: starting character blank " " has value 0.

i tried writing inline literal following ways: starting character blank `` `` has value 0. or starting character blank :literal:` ` has value 0. there few problems how these end working:

  1. rest syntax objects whitespace inside of literal, , doesn't recognized.
  2. the above can "fixed"--it looks correct in html () , plaintext (" ") output--with non-breaking space character inside literal, technically lie in our case, , if user copied character, wouldn't copying expect.
  3. the space can wrapped in regular quotes, allows literal recognized, , while output in html fine (" "), in plaintext ends double-quoted "" "".
  4. in both 2/3 above, if literal falls on wrap boundary, plaintext writer (which uses textwrap) gladly wrap inside literal , trim space because it's @ start/end of line.

i feel i'm missing something; there way handle this?

try using unicode character codes. if understand question, should work. 

here "|space|" , non-breaking space (|nbspc|)  .. |space| unicode:: u+0020 .. space .. |nbspc| unicode:: u+00a0 .. non-breaking space

you should see:

here “ ” , non-breaking space ( )


Comments

Post a Comment

Popular posts from this blog

python - No exponential form of the z-axis in matplotlib-3D-plots -

-
Image
i have similar problem described in how prevent numbers being changed exponential form in python matplotlib figure : i don't want (in special case) weird scientific formatting of axis. problem different have problem @ z -axis. 2-d plots can use ax.get_yaxis().get_major_formatter().set_useoffset(false) . , there no function ax.get_zaxis() what use format z -axis same way? edit: example: from mpl_toolkits.mplot3d import axes3d import numpy np import sys import matplotlib import matplotlib.pyplot pyplot def func(xi, ti): res = 10e3 + np.cos(ti) * np.sin(xi) return res if __name__ == '__main__': timespacing = 20 timestart = 0 timeend = 1 time = np.linspace(timestart, timeend, timespacing) widthspacing = 50 widthstart = 0 widthend = 3 width = np.linspace(widthstart, widthend, widthspacing) reslist = [] matplotlib.rcparams['legend.fontsize'] = 10 fig = pyplot.figure() ax = fig.gca(projection = '3d...
Read more

php - Best Light server (Linux + Web server + Database) for Raspberry Pi -

-
i install web server database on raspberry pi (little computer). computer has 1gb ram. i want know best combination: linux distribution , web server , dbms run local server multiple users minimal latency, use php on server. , best settings performance , not have bugs (memory usage, disable plugin, disable service, etc)? i thought light debian , lighttpd server , sqlite database. solution? i think lighttpd + sqlite great choice. linux distro, debian @ centos or tiny core linux , although i'm not sure of compatibility pi. obviously, can't go wrong raspbian if want use in production , more stable performance, few more pi's , set them in cluster .
Read more

c# - "Newtonsoft.Json.JsonSerializationException unable to find constructor to use for types" error when deserializing class -

-
i developing app in xamarin android. have splash screen serialize class , pass mainactivity using intent . when try deserialize in mainactivity error message : "serializationexception unable find constructor use types" serialization : void loaddata() { currency currency = new currency(this); intent = new intent(this, typeof(mainactivity)); intent.putextra("currency", newtonsoft.json.jsonconvert.serializeobject(currency)); startactivity(intent); } deserialization : cur = newtonsoft.json.jsonconvert.deserializeobject<currency> (intent.getstringextra("currency")); // error here class constructor : public currency(context context) { thiscontext = context; } i began experiencing problem after added parameter context context constructor. has caused this? how can solve it? possible serialize/deserialize class has parameters? you need have empty constructor in currency class in order deserialize it. ...
Read more