[TriLUG] OT: Maintaining public/private versions of a document

[Huan Truong via TriLUG]

- If you want good PDF output without dealing with all of the LaTEX
shenanigans, use Pandoc. It's markdown and it can output to a lot of
formats, PDF included.
- If you want a private and a public version, then you can perhaps
mark the private sections to start with a #, then make a makefile like
so:

public: source_file
    cat source_file | sed "s/^\#.*$//" > source_public
    <whatever command to compile your source_public file to pdf>

private: source_file
    cat source_file | sed "s/^\# //" > source_private
    <whatever command to compile your source_private file to pdf>

On Fri, Jul 26, 2019 at 1:15 PM Brian via TriLUG <trilug at trilug.org> wrote:
>
> Hi Gang,
>
> I'm wondering if anyone has any tips on good software to use for
> maintaining a document in two forms, a "private" version that is
> complete, and a "public" version that excludes certain portions of the
> private version.  I'd love to be able to only modify the private
> version, somehow mark which sections are private, and have the public
> version stay in sync.  I'm not super-concerned with what format the
> source is in, but publishing to annotated PDF (that is, PDF including
> working intradocument links) would be a hard requirement.
>
> Offhand I bet this is something LaTeX could handle, but I don't know
> anything about actually using LaTeX, and would prefer a WYSIWYG editing
> experience.
>
> The particular use case is API documentation for a project I'm on.
> There're parts of the API we don't intend to publish to others, but
> would like to maintain documentation on the entire interface.
>
> Thoughts?  Suggestions?  FOSS is good but not a requirement.
>
> Thanks!
> -Brian
> --
> This message was sent to: Huan Truong <webreg at tnhh.net>
> To unsubscribe, send a blank message to trilug-leave at trilug.org from that address.
> TriLUG mailing list : https://www.trilug.org/mailman/listinfo/trilug
> Unsubscribe or edit options on the web  : https://www.trilug.org/mailman/options/trilug/webreg%40tnhh.net
> Welcome to TriLUG: https://trilug.org/welcome