Publish: make comments appear in published document

9 次查看(过去 30 天)
I am using the publish function to create a documentation for my program. I am using code cells (lines starting with %%) to create sections in the published report. I know that the lines of comments following immediately after a %%-line will be regarded as descriptive text and appear as normal text in the published html-document (rather than as green comments as part of the code). Now I would like to find a way to mark comments that come further down in the cell to appear the same way in the published document (this is important, because I am not showing the code for all functions, and the comments that are part of the code will not appear then).
Here’s an example to illustrate what I mean:
%%Title1
% some comments
a = rand(5);
some more comments
b = a.^2;
even more comments
c = a+b;
This will publish to:
Title1
some comments
a = rand(5);
some more comments
b = a.^2;
even more comments
c = a+b;
This is somewhat unexpected behaviour, as I would expect (and want) it to publish to:
Title1
some comments
a = rand(5);
some more comments
b = a.^2;
even more comments
c = a+b;
Is there any way to achieve this? I know that using %% instead of %%% will make it publish this way, but that will split the code cell in the editor which I would like to avoid.

采纳的回答

per isakson
per isakson 2013-4-26
Here R2012a,64bit,Windows7 produces the html-result, which you expect.
The on-line help says:
Section title without cell break
%%%SECTION TITLE
% DESCRIPTIVE TEXT
I don't think the documentation has anything to say on the case that SECTION TITLE is empty.
  1 个评论
Christoph
Christoph 2013-4-26
Interesting, thanks! I am using 2011b (64bit, Windows7), so maybe that's what's causing the difference. Good to know if it works that way in the later version (so all I need to do is finally run the update :)).

请先登录,再进行评论。

更多回答(0 个)

类别

Help CenterFile Exchange 中查找有关 MATLAB Report Generator 的更多信息

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Translated by