c++ - 在狮身人面像文档中提取C++代码段

Question

我试图从我的资源中提取特定的代码片段(测试)以将其输出到文档中。

TEST_CASE("std::vector") {
//! [MyTest]
  std::vector<int> v = {42,43};
  CHECK( v.size() == 2 );
//! [MyTest]
}

在doxygen中，我可以通过 \snippet命令来引用它。

现在，我想将代码片段内的代码直接显示在sphinx文档中

You can create a std::vector just like this:

INSERT THE CODE BETWEEN [MyTest] MARKERS HERE

The std::vector class automatically allocates memory for you

我怎么做？我在“呼吸”中没有找到任何 doxygensnippet指令。

注意:我不介意狮身人面像直接使用任何类型的标签为我提取代码，我不需要符合Doxygen的要求。

Answer 1

感谢@Steve_Piercy，我得以找到想要的东西:将literalinclude指令与start-after和end-before结合使用。

TEST_CASE("std::vector") {
//! [MyTest begin]
  std::vector<int> v = {42,43};
  CHECK( v.size() == 2 );
//! [MyTest end]
}

文档文件:

You can create a std::vector just like this:

.. literalinclude::  my_test_file.cpp
  :start-after: MyTest begin
  :end-before: MyTest end

The std::vector class automatically allocates memory for you