小编mzj*_*zjn的帖子

我有一个像下面的xml

<root>    
<FIToFICstmrDrctDbt>
            <GrpHdr>
                <MsgId>A</MsgId>
                <CreDtTm>2001-12-17T09:30:47</CreDtTm>
                <NbOfTxs>0</NbOfTxs>
                <TtlIntrBkSttlmAmt Ccy="EUR">0.0</TtlIntrBkSttlmAmt>
                <IntrBkSttlmDt>1967-08-13</IntrBkSttlmDt>
                <SttlmInf>
                    <SttlmMtd>CLRG</SttlmMtd>
                    <ClrSys>
                        <Prtry>xx</Prtry>
                    </ClrSys>
                </SttlmInf>
                <InstgAgt>
                    <FinInstnId>
                        <BIC>AAAAAAAAAAA</BIC>
                    </FinInstnId>
                </InstgAgt>
            </GrpHdr>
    </FIToFICstmrDrctDbt>
</root>

我需要使用awk命令在单独的变量中提取每个标记值的值.怎么做？

我正在使用Docbook 5(docbook-xsl-ns),使用Apache FOP生成PDF,我想将所有文本移到左侧.我该怎么做？

源XML是:

<section>
        <title>Usage</title>
        <programlisting>mvn archetype:generate -DarchetypeGroupId=cz.csob.javor -DarchetypeArtifactId=javor-archetypes-subcomponent -DarchetypeVersion=X.Y.Z</programlisting>
        <para>During the subcomponent project generation you will be asked for the following properties:</para>
        <itemizedlist>
            <listitem>
                <para><emphasis>parent-component-id</emphasis> - ID of the parent component, should be the name of the directory the parent component project is placed in</para>
            </listitem>
            <listitem>...

谢谢.

我想使用sphinx构建我们的文档,并获得与NumPy文档相同的参数格式(https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt)

我发现有两种方法可以用sphinx记录第一种样式的参数,其中一种是

:param name: description

要么

:keyword name: description

和另一个(这是NumPy风格)

Parameters
----------
name: type
    description

以下是一个示例:

http://docs.scipy.org/doc/numpy/reference/distutils.html#module-numpy.distutils

和来源

def get_subpackage(self,subpackage_name,
                   subpackage_path=None,
                   parent_name=None,
                   caller_level = 1):
    """Return list of subpackage configurations.

    Parameters
    ----------
    subpackage_name: str,None
        Name of the subpackage to get the configuration. '*' in
        subpackage_name is handled as a wildcard.
    subpackage_path: str
        If None, then the path is assumed to be the local path plus the
        subpackage_name. If a setup.py file is not found in the
        subpackage_path, then …

我是doxygen和sphinx用法的新手.我需要创建用C语言编程的文档.我们的想法是从doxygen为每个文件生成xml文件,然后使用呼吸作为sphinx的桥梁来创建html页面.我成功生成了xml文件,并且能够获取html页面.但是,我看到每个html文件包含所有文件内容,而不是每个文件/目录的每个html.

ie. dir1 => file1.h and file1.c
    dir2 => file2.h and file2.c

输出:

file1.html => file1.xml & file2.xml
file2.html => file1.xml & file2.xml

预期产出

file1.html to contain file1.xml(both header the implementation)
file2.html for file2.xml

以下是设置:Doxyfile(doxygen)

GENERATE_XML = YES

conf.py(斯芬克斯)

breathe_projects = { <dir1_name>: <xml_path>,
                    <dir2_name>: <xml_path> }

有人可以帮我设置正确的配置以获得预期的输出吗？

我目前正在使用Sphinx和autodoc插件为我的python包编写文档.对于函数返回值,我可以写例如:returns: int: count,告诉sphinx存在类型为int的返回值,命名为count.

我现在有一个函数,它让我的数据库中的项目的前辈:

def get_previous_release(release_id):
    """ Holt Vorgängeritem eines Items mit der ID release_id

        :param release_id: ID des items für das Release
        :type release_id: int

    """

    if not isinstance(release_id, int):
        raise ValueError('get_previous_release expects an Integer value for the parameter release_id')

    try:
        release = my_queries.core.get_by_id(release_id)
    except IndexError:
        raise LookupError('The item with id {} could no be found'.format(release_id))

    if 'Alpha-Release' in release.name:
        release = AlphaRelease(release.key, release.name, release.state)
    elif 'Beta-Release' in release.name:
        release = BetaRelease(release.key, release.name, release.state)
    elif '-Release' in …

Sphinx 非常擅长链接到特定的 Python 对象。

例如，写

:func:`foo.bar`

将直接链接到bar中的函数foo.py。我想要相同的功能，但是我不希望创建可点击的链接，而是希望它是bar(), 的代码。

该.. code-block:: language指令要求您手动编写要添加的代码。但我想使用intersphinx链接到外部 Sphinx 项目中已存在的代码，而不是自己编写代码。:mod:、:func:、 和其他仅创建链接，实际上并不包含源代码。

还有，.. literalinclude:: filename但就我而言，我无法使用它，因为该函数来自 Sphinx 项目外部（它是使用 intersphinx 链接的，不是实际项目的一部分）。即使.. literalinclude:: filename可以以某种方式跨项目工作，我认为我仍然需要使用:lines:来过滤每个功能，这将是一个巨大的痛苦来跟踪。

如何通过名称空间路径引用函数/类并使用它将其源代码直接添加到 sphinx 第一个文件中？（不是可点击的链接，而是文字代码）。

在Sphinx中拆分源文档的正确方法是什么？

我有一个大文件,让我们称之为file1.rst,其结构如下:

Section 1
*********

Subsection 1
============

Subsection 2
============

Subsection 3
============

每个子部分都很长,源文件变得难以管理.我想将每个子节放在不同的源文件中.

我尝试了这个include指令:

Section 1
*********
.. include:: subsection1.rst
.. include:: subsection2.rst
.. include:: subsection3.rst

但是它发出的警告是,section1rst中的标签在section1.rst中是重复的(不是这样,标签只在子文档中).

或者,是否有可能更改TOC指令中的层次结构？

我一直在制定个人的“操作方法”指南，在我进行的过程中记录并保存我的学习日记。

我现在有一个几乎太长的代码块，当我自己遇到这么长的代码时，试图突出显示块而不突出整个页面总是令人沮丧，或者还不够。

所以，我的问题是，对于rst(reStructuredText).. code-block::的，是否有附加组件或添加copy按钮的方法，用于自动突出显示或自动将文本添加到用户剪贴板？或者这是否是我必须包含在构建中并在代码块中引用它的更多 html 文字类型的代码？如果是这样，那么类似的东西又会是什么样子？

如何在 sphinx/rst 的多个部分中使用相同的小节标题？

我不认为这是一个奇怪的用例。我只想为每个部分迭代相同的小节标题。

############
TITLE OF ALL
############

-------
CHAPTER
-------

SENARIO ONE
===========

Description
-----------

SENARIO TWO
===========

Description
-----------

生成此错误：

design_spec.rst:19: (INFO/1) Duplicate implicit target name: "description"

当然，我不会在整个文档中提出独特的小节标题。我错过了什么？

它抱怨标题生成的隐式目标名称不是唯一的。我该怎么办？

我试图了解由sphinx-quickstart. 这里是：

SPHINXOPTS    =
SPHINXBUILD   = sphinx-build
SPHINXPROJ    = myproj
SOURCEDIR     = source
BUILDDIR      = build

.PHONY: help Makefile

%: Makefile
    @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

令我困惑的几行是：

.PHONY: help Makefile
%: Makefile

我觉得我懂了：

1. 该%目标的手段捕获任何东西（通配符）。例如，如果我输入make html，%就会捕获html。
2. .PHONY Makefile意味着不make应该查找Makefile在其目录中调用的文件，因此，不应该检查文件的修改时间来确定是否运行规则。

我不明白：

为什么Makefile被列为目标的先决条件%。我的解释方式是：

捕获的目标规则%应在Makefile更改时运行。

但这在上下文中没有任何意义。我期望的是：

%当项目文档的源文件或 API 源文件发生更改时，应运行捕获的目标规则。

目录结构

.
??? build
??? Makefile
??? source
??? utils