<div dir="ltr">This is a really great work, thanks Bill! It would be great to get the book out there so the community can fix, improve and extend it.<div><br></div><div>To ask a dumb question. and I don't have skin this game either, is markdown the best way to go? Is a LaTeX book better? From what I understand here are tools that convert framemaker to LaTeX etc. I suspect that with LaTeX you'd end up with a better quality result, including things like indexing, cross referencing, etc. And are there other options we should consider?</div><div><br></div><div>Best,<br>Will</div><div><br></div><div><br><div><br></div><div><br></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Mar 29, 2018 at 3:22 PM, Bill Lorensen <span dir="ltr"><<a href="mailto:bill.lorensen@gmail.com" target="_blank">bill.lorensen@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Folks,<br>
<br>
Following my "bull in the china shop" approach to design by committee,<br>
I have converted Chapter 6 of the VTK Textbook to markdown and the<br>
mkdocs flavor.<br>
<br>
See: <a href="https://lorensen.github.io/VTKExamples/site/VTKBook/Chapter6/" rel="noreferrer" target="_blank">https://lorensen.github.io/<wbr>VTKExamples/site/VTKBook/<wbr>Chapter6/</a><br>
<br>
This approach is meant to be a Strawman.<br>
<br>
Here is what I did:<br>
<br>
1) I used pandoc to convert the VTK Textbook PDF to .txt and .md<br>
files. The conversion of the main text was excellent. Figures, tables,<br>
and equations not so good.<br>
<br>
2) I cleaned up much of the cruft manually with emacs.<br>
<br>
3) I added links to all of the VTKBookFigures<br>
(<a href="https://lorensen.github.io/VTKExamples/site/VTKBookFigures/" rel="noreferrer" target="_blank">https://lorensen.github.io/<wbr>VTKExamples/site/<wbr>VTKBookFigures/</a>). Andrew<br>
and I had created these a while ago. The figures contain links to the<br>
C++ and Python code that generated the figures.<br>
<br>
4) The chapter passes through the normal ScrapeRepo and<br>
SyncSiteWithRepo scripts that are used to maintain the static website.<br>
As part of this process, I insert doxygen links to any vtk class<br>
mentioned in the document. I still have a small issue with this<br>
process.<br>
<br>
Once I figured out an approach to handle figures, it took about 8<br>
hours of manual labor to convert the chapter.<br>
<br>
What needs to be done on the Chapter 6 Strawman?<br>
<br>
1) Add the math.<br>
<br>
2) Add the non-vtk generated figures.<br>
<br>
3) More cleanup.<br>
<br>
Other than 1 and 2, I will continue on cleanup.<br>
<br>
There are several future issues.<br>
<br>
Converting the text to markdown does not require a brain surgeon. But,<br>
editing the content to modern VTK will require more effort. Also,<br>
there are lots of old concepts. Andrew and I have already converted<<br>
all of the .tcl scripts to C++ and Python. They exist as examples on<br>
this page (<a href="https://lorensen.github.io/VTKExamples/site/VTKBookFigures/" rel="noreferrer" target="_blank">https://lorensen.github.io/<wbr>VTKExamples/site/<wbr>VTKBookFigures/</a>).<br>
But subjects like the web should probably be replaced with the<br>
javascript stuff that is going on at Kitware.<br>
<br>
Also, there are concepts that are not addressed in the current VTK<br>
Textbook including shaders, color management, etc.<br>
<br>
Please provide feedback/suggestions. I don't have much skin in this<br>
game. If the approach looks wrong I'll gladly remove the current<br>
strawman and reconcentrate my efforts on making the VTKExamples<br>
better.<br>
<span class="HOEnZb"><font color="#888888"><br>
<br>
Bill<br>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>William J. Schroeder, PhD<br>Kitware, Inc. - Building the World's Technical Computing Software<br>28 Corporate Drive<br>Clifton Park, NY 12065<br><a href="mailto:will.schroeder@kitware.com" target="_blank">will.schroeder@kitware.com</a><br><a href="http://www.kitware.com" target="_blank">http://www.kitware.com</a><br>(518) 881-4902</div></div></div>
</div>