documentation-generation

Use roxygen2 to document multiple datasets in a single documentation object

ぃ、小莉子 提交于 2021-02-17 03:00:55
问题 I'm looking for an equivalent of @describeIn that will allow me to create a single documentation object for multiple R data objects. I had hoped that something like this: #' Tree Distances #' #' These datasets contain the distances between sets #' of 10-tip, 11-tip and 12-tip trees. #' #' @name treeDistances #' @keywords datasets "treeDistances10" "treeDistances11" "treeDistances12" would produce a single manual page that would apply to all three treeDistances## objects, similar to describing

Antora top navigation bar customization

喜你入骨 提交于 2021-02-07 19:11:55
问题 My question is quite simple though I cannot find anything that points to it in the documentation. I am generating documentation for a project with the default generator in Antora but I cannot figure out how to customize the top navigation bar, items on the right side, which have some defaults. Since the site is generated, where should I change, or how, those items? I do not want to list such items there. 回答1: There is an additional approach that does not require you to create a standalone UI:

Using sphinx to auto-document a python class, module

ⅰ亾dé卋堺 提交于 2020-01-22 05:17:40
问题 I have installed Sphinx in order to document some python modules and class I'm working on. While the markup language looks very nice, I haven't managed to auto-document a python code. Basically, I have the following python module: SegLib.py And A class called Seg in it. I would like to display the docstrings of the class and module within the generated sphinx document, and add further formatted text to it. My index.rst looks like this: Contents: .. toctree:: :maxdepth: 2 chapter1.rst and

Using sphinx to auto-document a python class, module

天涯浪子 提交于 2020-01-22 05:17:13
问题 I have installed Sphinx in order to document some python modules and class I'm working on. While the markup language looks very nice, I haven't managed to auto-document a python code. Basically, I have the following python module: SegLib.py And A class called Seg in it. I would like to display the docstrings of the class and module within the generated sphinx document, and add further formatted text to it. My index.rst looks like this: Contents: .. toctree:: :maxdepth: 2 chapter1.rst and

How to generate a legend with colors in PlantUML?

你说的曾经没有我的故事 提交于 2020-01-13 08:18:06
问题 I want to color classes in my class diagram, based on a certain criteria, and then display a legend, that would look roughly like: If I could add an HTML table within PlantUML's legend and endlegend , I could achieve this by changing the cell backgrounds. However, adding the HTML <table> doesn't work. I also tried using PlantUML's salt to insert a table, but I couldn't find any way to color the cells of the table. Is there any way to achieve this? 回答1: This is not perfect, but you can use a

Doxygen: Empty Detail Description

核能气质少年 提交于 2020-01-13 03:48:07
问题 Context - Doxygen tool on C codes to generated RTF documents. In the documentation of Modules/Groups, we are getting the header "Detailed Description" even if no detail description is provided for some particular module/group. In generated RTF document this looks ugly. Is it possible to get rid of this empty Detail Description sections? I tried "ALWAYS_DETAILED_SEC = NO" but it is not working. I cannot do "HIDE_UNDOC_MEMBERS = YES" as the group/module contains members (struct, functions ...)

How can I convert an RTF file to a pdf file?

吃可爱长大的小学妹 提交于 2020-01-12 09:07:11
问题 How can I convert an RTF file to a PDF one? I have the adobe PDF printer, should I use it? If so, how can I programmatically access it? 回答1: You can use a PDF printer, but then you still have a few problems to solve. In order to handle text that spans multiple pages, you need this article to create a descendant of RichTextbox that handles the EM_FORMATRANGE Message. There are a lot of (free) PDF printer out there, but I found that only BioPdf will let you control the filename of the output.

How to create documentation for instance variable and methods in Xcode?

点点圈 提交于 2020-01-10 14:35:27
问题 I'd like to be able to Alt-Click an instance variable (or a method) as part of the program i created and read what it's purpose is. The fact that Xcode is telling me the class variable is declared at - is nice but not enough. In this case i'd like to see custom text i typed to describe what an asset really is. Additionally type of the ivar would also be useful to know. How can this be done? In this case, i wonder what exactly did i mean by assets I specifically wonder if this information can