<div dir="ltr"><div dir="auto">Andras,</div><div dir="auto"><br></div><div dir="auto">I think I could automate link between figure references and the figures. I'll take a look.</div><div dir="auto"><br></div><br><div class="gmail_quote"><div dir="ltr">On Thu, Mar 29, 2018, 12:34 PM Andras Lasso <<a href="mailto:lasso@queensu.ca" target="_blank">lasso@queensu.ca</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thank you Bill, this is looks awesome! It is nicely readable - even on portrait screen orientation (e-readers, phones), searchable, hyperlinkable section titles.<br>
<br>
One nice improvement would be to make figure reference (e.g., Figure6-39) hyperlinked to the figure, so that if I click on it then the page scrolls there.<br>
<br>
Would be nice to make biblio references (e.g., [Wyszecki82]) hyperlinked, too, but only if it's easy to do.<br>
<br>
Andras<br>
<br>
-----Original Message-----<br>
From: Bill Lorensen <<a href="mailto:bill.lorensen@gmail.com" rel="noreferrer" target="_blank">bill.lorensen@gmail.com</a>><br>
Sent: Thursday, March 29, 2018 3:23 PM<br>
To: VTK Developers <<a href="mailto:vtk-developers@vtk.org" rel="noreferrer" target="_blank">vtk-developers@vtk.org</a>>; VTK Users <<a href="mailto:vtkusers@vtk.org" rel="noreferrer" target="_blank">vtkusers@vtk.org</a>><br>
Cc: Will <<a href="mailto:will.schroeder@kitware.com" rel="noreferrer" target="_blank">will.schroeder@kitware.com</a>>; Ken <<a href="mailto:ken.martin@kitware.com" rel="noreferrer" target="_blank">ken.martin@kitware.com</a>>; Berk Geveci <<a href="mailto:berk.geveci@kitware.com" rel="noreferrer" target="_blank">berk.geveci@kitware.com</a>>; Andras Lasso <<a href="mailto:lasso@queensu.ca" rel="noreferrer" target="_blank">lasso@queensu.ca</a>>; Andrew Maclean <<a href="mailto:andrew.amaclean@gmail.com" rel="noreferrer" target="_blank">andrew.amaclean@gmail.com</a>><br>
Subject: Request for Feedback: VTK Textbook Strawman<br>
<br>
Folks,<br>
<br>
Following my "bull in the china shop" approach to design by committee, I have converted Chapter 6 of the VTK Textbook to markdown and the mkdocs flavor.<br>
<br>
See: <a href="https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Florensen.github.io%2FVTKExamples%2Fsite%2FVTKBook%2FChapter6%2F&data=02%7C01%7Classo%40queensu.ca%7Cd69312dd725d4229c7a608d595aa6c11%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636579481544635694&sdata=PctmleYfeo8Xkda2fsRZJlcybPoe7DgT5E2LtG%2FNnIY%3D&reserved=0" rel="noreferrer noreferrer" target="_blank">https://na01.safelinks.<wbr>protection.outlook.com/?url=<wbr>https%3A%2F%2Florensen.github.<wbr>io%2FVTKExamples%2Fsite%<wbr>2FVTKBook%2FChapter6%2F&data=<wbr>02%7C01%7Classo%40queensu.ca%<wbr>7Cd69312dd725d4229c7a608d595aa<wbr>6c11%<wbr>7Cd61ecb3b38b142d582c4efb2838b<wbr>925c%7C1%7C0%<wbr>7C636579481544635694&sdata=<wbr>PctmleYfeo8Xkda2fsRZJlcybPoe7D<wbr>gT5E2LtG%2FNnIY%3D&reserved=0</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 files. The conversion of the main text was excellent. Figures, tables, 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 (<a href="https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Florensen.github.io%2FVTKExamples%2Fsite%2FVTKBookFigures%2F&data=02%7C01%7Classo%40queensu.ca%7Cd69312dd725d4229c7a608d595aa6c11%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636579481544635694&sdata=y2MzDqU%2FIuambSesKZRlGMneBsTtc3JiOVQo5jN1Un0%3D&reserved=0" rel="noreferrer noreferrer" target="_blank">https://na01.safelinks.<wbr>protection.outlook.com/?url=<wbr>https%3A%2F%2Florensen.github.<wbr>io%2FVTKExamples%2Fsite%<wbr>2FVTKBookFigures%2F&data=02%<wbr>7C01%7Classo%40queensu.ca%<wbr>7Cd69312dd725d4229c7a608d595aa<wbr>6c11%<wbr>7Cd61ecb3b38b142d582c4efb2838b<wbr>925c%7C1%7C0%<wbr>7C636579481544635694&sdata=<wbr>y2MzDqU%<wbr>2FIuambSesKZRlGMneBsTtc3JiOVQo<wbr>5jN1Un0%3D&reserved=0</a>). Andrew 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 SyncSiteWithRepo scripts that are used to maintain the static website.<br>
As part of this process, I insert doxygen links to any vtk class mentioned in the document. I still have a small issue with this process.<br>
<br>
Once I figured out an approach to handle figures, it took about 8 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, editing the content to modern VTK will require more effort. Also, there are lots of old concepts. Andrew and I have already converted< all of the .tcl scripts to C++ and Python. They exist as examples on this page (<a href="https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Florensen.github.io%2FVTKExamples%2Fsite%2FVTKBookFigures%2F&data=02%7C01%7Classo%40queensu.ca%7Cd69312dd725d4229c7a608d595aa6c11%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636579481544635694&sdata=y2MzDqU%2FIuambSesKZRlGMneBsTtc3JiOVQo5jN1Un0%3D&reserved=0" rel="noreferrer noreferrer" target="_blank">https://na01.safelinks.<wbr>protection.outlook.com/?url=<wbr>https%3A%2F%2Florensen.github.<wbr>io%2FVTKExamples%2Fsite%<wbr>2FVTKBookFigures%2F&data=02%<wbr>7C01%7Classo%40queensu.ca%<wbr>7Cd69312dd725d4229c7a608d595aa<wbr>6c11%<wbr>7Cd61ecb3b38b142d582c4efb2838b<wbr>925c%7C1%7C0%<wbr>7C636579481544635694&sdata=<wbr>y2MzDqU%<wbr>2FIuambSesKZRlGMneBsTtc3JiOVQo<wbr>5jN1Un0%3D&reserved=0</a>).<br>
But subjects like the web should probably be replaced with the javascript stuff that is going on at Kitware.<br>
<br>
Also, there are concepts that are not addressed in the current VTK Textbook including shaders, color management, etc.<br>
<br>
Please provide feedback/suggestions. I don't have much skin in this game. If the approach looks wrong I'll gladly remove the current strawman and reconcentrate my efforts on making the VTKExamples better.<br>
<br>
<br>
Bill<br>
</blockquote></div></div>