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

excel vba - VBA Proxy auto-configuration for http requests -

-
i need build client web api in vba , needs work behind proxy (with authentication). i've been looking @ winhttp.winhttprequest , msxml2.xmlhttp/serverxmlhttp classes. turns out that: xmlhttp automatically detects proxy settings provided through proxy.pac file (good) winhttprequest doesn't (bad) however, on other hand: xmlhttp automatically follows redirects, , there's no way of disabling behaviour (bad) winhttprequest doesn't (good) since i'd able have cake , eat it, there way automatic proxy configuration component such winhttprequest doesn't follow redirects blindly? the vba-web project might pastry eating problem. https://github.com/vba-tools/vba-web i guess wish go like: dim client new webclient client .baseurl = "https://www.google.com" .proxyusername = <user> .proxypassword = <password> .enableautoproxy = true end dim request new webrequest request .method = webmethod.httpget ...
Read more

python - concatenating scipy matrices -

-
i want concatenate 2 csr_matrix, each shape=(1,n) . i know should use scipy.sparse.vstack : from scipy.sparse import csr_matrix,vstack c1 = csr_matrix([[1, 2]]) c2 = csr_matrix([[3, 4]]) print c1.shape,c2.shape print vstack([c1, c2], format='csr') #prints: (1, 2) (1, 2) (0, 0) 1 (0, 1) 2 (1, 0) 3 (1, 1) 4 however, code fails: from scipy.sparse import csr_matrix,vstack import numpy np y_train = np.array([1, 0, 1, 0, 1, 0]) x_train = csr_matrix([[1, 1], [-1, 1], [1, 0], [-1, 0], [1, -1], [-1, -1]]) c0 = x_train[y_train == 0].mean(axis=0) c1 = x_train[y_train == 1].mean(axis=0) print c0.shape, c1.shape #prints (1l, 2l) (1l, 2l) print c0,c1 #prints [[-1. 0.]] [[ 1. 0.]] print vstack([c0,c1], format='csr') the last line raises exception - file "c:\anaconda\lib\site-packages\scipy\sparse\construct.py", line 484, in vstack return bmat([[b] b in blocks], format=format, dtype=dtype) file "c:\anaconda\li...
Read more