如何阻止Sphinx在手册页中发出U​​nicode字符?

时间:2017-08-14 06:41:21

标签: python-sphinx restructuredtext

在解析public function authenticated(\Illuminate\Http\Request $request, \App\User $user) { if ($to = $request->input('redirect_route')) { $to = URL::route($to); } $to = $to ?: $this->redirectPath(); return redirect()->intended( $to ); } 源文件时,Sphinx似乎将.rst--等序列转换为Unicode字符。这通常是不合适的,因为这种标点通常是逐字逐句的,例如,记录程序命令行时。

这是一个小小的完整示例:

...

制作的手册页的mkdir doc echo '**foobar** [options ...] [--] <*args*> ...' > doc/contents.rst echo '**foobar** **--do-something**' >> doc/contents.rst touch doc/conf.py sphinx-build -b man doc out 替换为...(省略号字符),更糟糕的是,带有[--](带有短划线)和{{1使用[–](使用em-dash)。

0 个答案:

没有答案