Getting published markup to work correctly

12 次查看（过去 30 天）
Chuck Noise
Chuck Noise 2023-8-17
评论： Chuck Noise 2023-8-29
Hi
I am trying to make some good looking help texts for a bunch of functions. I am trying out the publish option, which I never used before, and I am having a bit of troubles with it.
I made a test function (test_f.m) to get acquainted with the publishing function. Firstly, I just copy/pasted an example from the Publishing Markup documentation from mathworks (https://se.mathworks.com/help/matlab/matlab_prog/marking-up-matlab-comments-for-publishing.html):
%% Vector Operations
% You can perform a number of binary operations on vectors.
%%
A = 1:3;
B = 4:6;
%% Dot Product
% A dot product of two vectors yields a scalar.
% MATLAB has a simple command for dot products.
s = dot(A,B);
%% Cross Product
% A cross product of two vectors yields a third
% vector perpendicular to both original vectors.
% Again, MATLAB has a simple command for cross products.
v = cross(A,B);
And then I published it to see how it worked. Now after publishing, if I type help test_f in the command window or hover over the test_f and press f1 I get this:
Which doesn't look good at all.
If I follow the link for showdemo_test_f a new window is opened:
Which shows the help text just as I want it.
My question is whether it is possible to get this correctly looking help text to be displayed when you use f1 amd similarly get something more that 2 lines and a hyperlink when using help test_f?
EDIT:
I just have an additional question: Are you ment to make a seperate .m file for the help text or could you have both the help text and the actual code for the function in the same .m file?
Thanks
  4 个评论
显示 2更早的评论
Chuck Noise
Chuck Noise 2023-8-17
编辑：Chuck Noise 2023-8-17
In all fairness it doesn't really change that much whether I get the right look of the help text or not, but I just like when it looks good :)
In looking for tutorials about making publishing markup I found almost nothing so it seems that it's not something other people really worry about
Rik
Rik 2023-8-17
Generating nice documentation for functions seems to be a fairly niche wish. I primarily use the publish function to generate documentation for my FEX submissions, but I generate an m-file from components I wrote to do that.
I hope Mathworks is working on a way to make it easier to write a function in such a way that you can integrate nice-looking documentation and the tab completion in the m-file itself.
I never use that smaller popup myself because it is so small, so if you've read the documentation and did a google search, I don't think there is much I can do for you.

请先登录，再进行评论。

请先登录，再回答此问题。

采纳的回答

Divyanshu
Divyanshu 2023-8-29
Hi Chuck,
I understand the issue you are facing; you can go through the following explanation:
  • The difference in the views is because when we use Publish a proper formatted HTML page is rendered in the web-browser. On the other hand, when we use ‘help’ command for the same function it uses a plain-text format to display the information.
  • For built-in functions like “optimoptions” information is displayed in proper UI when hovered over and pressed F1, because separate HTML pages are created for each of such functions.
However, if you want to get similar UI then you can make use of ‘publish’ function which can be called directly from your MATLAB script.
For more details about ‘publish’ function of MATLAB refer the following documentation:
Generate view of MATLAB file in specified format - MATLAB publish (mathworks.com)

更多回答（0 个）

类别

在 Help Center 和 File Exchange 中查找有关 Environment and Settings 的更多信息

标签

Community Treasure Hunt

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

Start Hunting!

Translated by