Should I ever turn $DEExport ON?
The value of $DEExport determines whether $DisplayName or $Name is exported as the note’s title.
If $DEExport is set to true, post and sub-post titles will export as whatever fancy $DisplayName you have concocted.
How is such a thing possible? It is customary to use ^title^ (which exports $Name) to export headings. But BoxPress uses a macro rather than ^title^ or ^value($DisplayName)^, and the macro checks the value of a bool to decide which format to use. That bool is $DEExport.
It’s a good idea to turn $DEExport OFF for nearly all of your exports. Number gets its own special handling, so there’s no need to turn $DEExport ON for the sake of numbering. Proticons are replaced with neater Glyphicons; audio_note even indicates whether audio file is present or not.
The best time to turn $DEExport ON is when you want to disguise the actual $Name.
It may be a good idea to turn $DEExport ON for the code_note and normal_note prototypes.
It should always be turned on for code_note since these prepend type-names, and should be usually turned on for normal_note since these often hide their $Names.
$Name here shows why I have turned $DEExport ON for these notes. You cannot include the names of prototypes inside other note names without causing serious problems. So I had give the notes that describe the prototypes ridiculous names—and then cover them over with the display expression.