Live Editor formatting and indents

9 views (last 30 days)
I've been ignoring the Live Editor for a while, because most of my programming is done using classes and functions rather than scripts. However, I ran across articles on Literate programming, and they convinced me that there was real value in programming as a document. Also, I struggle with documenting my code (get it working, and worry about documentation tomorrow...), and the Live Editor seemed like a good fix for that.
As a test project, I took one of my functions, converted it to a live function, converted all the comments to Text, and added additional documentation and formatting (bold headers, etc). On the whole, I like the result - however, I find that the interspersal of text with code blocks tends to obscure the indentation levels. There are clearly some steps which can be taken to make the indentation clearer. I've decided that it's good practice to end a live code block (between text areas) on the same indent level that you entered at.
I'm going to do a for loop
for idx = 1:5
insert explanation for next step
is confusing. Better to split it up like:
I'm going to do a for loop. discussion of all the stuff the for loop is going to do
for idx = 1:
%brief comment inserted inline
finished with the for loop, explanation of all the next steps
This is helpful, but I feel that the indent structure would be clearer if I could set the live editor text to indent paragraphs to the same level as the code. It looks like I can set the indent of the first line of a paragraph to match the code, but following lines revert to the left edge.

Accepted Answer

Michael Abboud
Michael Abboud on 2 Apr 2019
Hi Pat, this is actually something that we have been considering -- adding support to indent rich text to match the indentation of nearby code. We think that this may help to better integrate code and text for certain workflows, and from your post -- it sounds like this is one of those workflows.
It's good to see that there is some desire for this functionality, and it's always great to get concrete examples of how it would be used. Thanks for sharing your thoughts!
  1 Comment
Nicholas Kiratzis
Nicholas Kiratzis on 20 Aug 2020
Edited: Nicholas Kiratzis on 20 Aug 2020
Any recent updates for this livescript functionality? I second Pat's use case.

Sign in to comment.

More Answers (1)

Alexandra Ritger
Alexandra Ritger on 13 May 2020
Hi, I'm also wondering if text indentation is an option, or if the the for loop can have a bracket from start to finish like it does in the editor window?


Find more on Live Scripts and Functions in Help Center and File Exchange

Community Treasure Hunt

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

Start Hunting!