[vtkusers] [vtk-developers] Request for Feedback: VTK Textbook Strawman

[Andras Lasso]

Despite all its limitations, Markdown is becoming one of the most widely used standard in technical writing. You can get books authored in Markdown published as hardcopy, see for example http://docs.atlas.oreilly.com/writing_in_markdown.html.

If we can live without sophisticated typesetting then we could save a lot of time and be “compatible” with many more potential authors and online publishing services by using Markdown instead of Latex.

ITK software guide is written in Latex, we could ask ITK folks about how happy they are with it.

Andras

From: vtk-developers <vtk-developers-bounces at vtk.org> On Behalf Of Berk Geveci
Sent: Friday, March 30, 2018 9:34 AM
To: Bill Lorensen <bill.lorensen at gmail.com>
Cc: VTK Developers <vtk-developers at vtk.org>; VTK Users <vtkusers at vtk.org>; Andrew Maclean <andrew.amaclean at gmail.com>; Will Schroeder <will.schroeder at kitware.com>
Subject: Re: [vtk-developers] [vtkusers] Request for Feedback: VTK Textbook Strawman

Wouldn't a tool like pandoc allow us to maintain some sort of markdown that can be converted to both something online and LaTeX at the same time? It would be great to support both as we would be interested in support a print-on-demand kind of book on Amazon. There are still people out there that like printed books (like me :-) ).

On Fri, Mar 30, 2018 at 9:09 AM, Bill Lorensen <bill.lorensen at gmail.com<mailto:bill.lorensen at gmail.com>> wrote:
Will, I guess I did not envision a traditional book. This is a web site that is alive. It will present well on all platforms including mobile. Things like indexes aren't really needed.

That said if folks want latex so be it. Not me. I can fill my time with other stuff.

In the meantime, I'll do some more experiments.

Bill

On Fri, Mar 30, 2018, 5:30 AM Matthew Brett <matthew.brett at gmail.com<mailto:matthew.brett at gmail.com>> wrote:
Hi,

On Fri, Mar 30, 2018 at 1:04 PM, Andrew Maclean
<andrew.amaclean at gmail.com<mailto:andrew.amaclean at gmail.com>> wrote:
> I would seriously consider LaTeX for the reasons mentioned. Additionally, it
> is really well suited for rendering equations.

I don't know much about mkdocs, but I believe you can configure it to
render LaTeX equations:

https://github.com/mkdocs/mkdocs/issues/253#issuecomment-196486412<https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fmkdocs%2Fmkdocs%2Fissues%2F253%23issuecomment-196486412&data=02%7C01%7Classo%40queensu.ca%7C04fe24766d1d4373f50d08d59642fd84%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636580136826681742&sdata=QSrA0t9a7A23wTzX2L%2F62GQMOD5n77%2FklekJt4%2FSpq4%3D&reserved=0>

Cheers,

Matthew
_______________________________________________
Powered by www.kitware.com<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.kitware.com&data=02%7C01%7Classo%40queensu.ca%7C04fe24766d1d4373f50d08d59642fd84%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636580136826691746&sdata=Qrq04VrqQHL88FwaURuTILosfbcsYPNLtRABsNR8ZCg%3D&reserved=0>

Visit other Kitware open-source projects at http://www.kitware.com/opensource/opensource.html<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.kitware.com%2Fopensource%2Fopensource.html&data=02%7C01%7Classo%40queensu.ca%7C04fe24766d1d4373f50d08d59642fd84%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636580136826691746&sdata=IDUbvpkxB3jCa2nOmU5Z8W978OijbaauByo0uOrG1pw%3D&reserved=0>

Please keep messages on-topic and check the VTK FAQ at: http://www.vtk.org/Wiki/VTK_FAQ<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.vtk.org%2FWiki%2FVTK_FAQ&data=02%7C01%7Classo%40queensu.ca%7C04fe24766d1d4373f50d08d59642fd84%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636580136826691746&sdata=LdUxhmHeBvv5Ak5kFFjFFaB0uHkMPpf0rGFev23g5O4%3D&reserved=0>

Search the list archives at: http://markmail.org/search/?q=vtkusers<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fmarkmail.org%2Fsearch%2F%3Fq%3Dvtkusers&data=02%7C01%7Classo%40queensu.ca%7C04fe24766d1d4373f50d08d59642fd84%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636580136826691746&sdata=RdHzM3YWcrHkYA%2FYWj6R0ywKUeilGSauJaR9sdSlcHI%3D&reserved=0>

Follow this link to subscribe/unsubscribe:
https://vtk.org/mailman/listinfo/vtkusers<https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fvtk.org%2Fmailman%2Flistinfo%2Fvtkusers&data=02%7C01%7Classo%40queensu.ca%7C04fe24766d1d4373f50d08d59642fd84%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636580136826691746&sdata=qRawBC1%2FqRw%2Bc7bk959eBbyiAYP2%2FcZa2j93xEVhAkM%3D&reserved=0>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://vtk.org/pipermail/vtkusers/attachments/20180330/23e4f4db/attachment.html>