Thanks to Kit Baum a new version of smclpres is now available from SSC. To install type in Stata ssc install smclpres, replace.
smclpres allows you to create a smcl presentation withing Stata. This is somewhat "niche", and primarily useful for talks about how to do things in Stata, like a lecture on graphs in Stata or a talk at a Stata Users' Group meeting. In those cases a .smcl presentation can be useful. A .smcl presentation is a series of linked .smcl files that open in the viewer inside Stata (like help-files). The strength of a .smcl presentation is that it can contain links that execute examples, open help files, open .do files, etc.
A .smcl presentation is all about illustrating how to do something in Stata, so preparing for such a talk typically starts with preparing a set of examples in .do file. By adding specific comments to that do-file, e.g. to indicate when a slide starts and when it ends, what the title of the slide is, etc, the -smclpres- program can turn that .do file in a .smcl presentation. This .smcl presentation can also be transformed to a .html handout.
A recent example of such a presentation is the presentation I held at the last Swiss Stata Conference: https://www.stata.com/meeting/switze...and22_Buis.zip
This new version of smclpres has the following improvements:
smclpres allows you to create a smcl presentation withing Stata. This is somewhat "niche", and primarily useful for talks about how to do things in Stata, like a lecture on graphs in Stata or a talk at a Stata Users' Group meeting. In those cases a .smcl presentation can be useful. A .smcl presentation is a series of linked .smcl files that open in the viewer inside Stata (like help-files). The strength of a .smcl presentation is that it can contain links that execute examples, open help files, open .do files, etc.
A .smcl presentation is all about illustrating how to do something in Stata, so preparing for such a talk typically starts with preparing a set of examples in .do file. By adding specific comments to that do-file, e.g. to indicate when a slide starts and when it ends, what the title of the slide is, etc, the -smclpres- program can turn that .do file in a .smcl presentation. This .smcl presentation can also be transformed to a .html handout.
A recent example of such a presentation is the presentation I held at the last Swiss Stata Conference: https://www.stata.com/meeting/switze...and22_Buis.zip
This new version of smclpres has the following improvements:
- It allows a source file for the presentation to include other source files with //include filename.do. This makes it easier to manage large presentations: Rather than having one very large source file, you can have one source file for each section of the talk, and bring it all together in a main source file with //include. Error messages now give the line number and the file where the error occurred.
- You now can (and should) set the version of smclpres with the //version command. It serves the same purpose as version in Stata: if in the future I change something in smclpres and you set the version, then those changes won't break your presentation. So you can safely update smclpres to the latest version without having to fear that you break any presentations you have already written.
- new cleaner syntax for specifying font, position, and hline
- It fixes a bug that could happen in very large presentations.
- The entire system has been rewritten to use Mata's classes. This doesn't impact the user, but it makes it easier for me to maintain and expand this package.
