[vtk-developers] VTK Textbook Efforts Update

Wed Apr 25 18:24:42 EDT 2018

Hi Andras,
   As Bill mentioned the goals are different.

The LaTex version (pdf) is actually looking really good on phones and
tablets using the Adobe PDF reader. If a new version of the book is
produced, it maybe that the rewrite would be done in LaTex as it seems
fairly straightforward to convert to markdown and do manual fixes. I
suspect scripting will be able to handle most of the conversion from LaTex
to the markdown used by Bill.

I don't see it as a major issue having two versions as long as changes are
reflected in both versions.
Also the community with their eagle eyes will pick up issues and fix them!

Regards
   Andrew

On Thu, Apr 26, 2018 at 1:36 AM, Bill Lorensen <bill.lorensen at gmail.com>
wrote:

> The two versions have different goals. Currently, the Latex version is
> duplicating the existing hard copy except it has more links and many
> figures that are produced for the VTKExamples.
>
> The Markdown version is platform friendly (desktop, tablet, mobile). It
> also has links to doxygen, and the VTKExamples where appropriate. It does
> not attempt to reproduce the layout of the hard copy book.
>
> Both versions share some common artifacts like the VTKExamples, Bernhard's
> Latex Equations.
>
>
>
> On Wed, Apr 25, 2018 at 5:53 AM, Andras Lasso <lasso at queensu.ca> wrote:
>
>> Is the plan to maintain and improve two independent versions of the book?
>> It would be much more efficient to have a single master version and
>> generate the other version automatically. Since most readers would not
>> print the book, a high-quality Markdown version would be more important;
>> and Latex can be generated.
>>
>>
>>
>> Andras
>>
>>
>>
>> *From:* vtk-developers <vtk-developers-bounces at vtk.org> *On Behalf Of *Andrew
>> Maclean
>> *Sent:* Wednesday, April 25, 2018 5:44 AM
>> *To:* VTK Developers <vtk-developers at vtk.org>
>>
>> *Subject:* Re: [vtk-developers] VTK Textbook Efforts Update
>>
>>
>>
>> Oops, I'll fix this in the VTKLaTex document tomorrow, thanks.
>>
>> Andrew Maclean
>>
>>
>>
>> On Wed, 25 Apr 2018, 19:28 <vtk-developers-request at vtk.org> wrote:
>>
>> Send vtk-developers mailing list submissions to
>>         vtk-developers at vtk.org
>>
>> To subscribe or unsubscribe via the World Wide Web, visit
>>         https://vtk.org/mailman/listinfo/vtk-developers
>> <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fvtk.org%2Fmailman%2Flistinfo%2Fvtk-developers&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=DhjKUui1dgFU1Z8kMtrAPkbixboZPnOpWI8FQLtIYgg%3D&reserved=0>
>> or, via email, send a message with subject or body 'help' to
>>         vtk-developers-request at vtk.org
>>
>> You can reach the person managing the list at
>>         vtk-developers-owner at vtk.org
>>
>> When replying, please edit your Subject line so it is more specific
>> than "Re: Contents of vtk-developers digest..."
>> Today's Topics:
>>
>>    1. Re: VTK Textbook Efforts Update (Chiranjib Sur)
>>
>>
>>
>> ---------- Forwarded message ----------
>> From: Chiranjib Sur <sur.chiranjib at gmail.com>
>> To: Bill Lorensen <bill.lorensen at gmail.com>
>> Cc: VTK Developers <vtk-developers at vtk.org>, VTK Users <vtkusers at vtk.org>
>> Bcc:
>> Date: Wed, 25 Apr 2018 14:58:51 +0530
>> Subject: Re: [vtk-developers] VTK Textbook Efforts Update
>>
>> Hi,
>>
>> At this point to time how can we help in proof reading and update the
>> observation (any repository to add the feedback?)?
>>
>>
>>
>> For example, I found there is typo in Eq 3.7. The component t_z in the
>> T_T matrix is replaced by ZERO. It should be t_z. (See the screen shot
>> below)
>>
>>
>>
>>
>>
>>
>>
>> Thanks and regards,
>>
>> Chiranjib
>>
>>
>>
>> On Tue, Apr 24, 2018 at 1:32 AM, Bill Lorensen <bill.lorensen at gmail.com>
>> wrote:
>>
>> Folks,
>>
>> We are pleased to provide an update on efforts to update the online
>> resources for the fourth edition of the  VTK textbook
>>
>> There are 3 coordinated efforts ongoing each with a different goal.
>> Currently, none of the efforts will rewrite sections of the fourth
>> edition. These are the first steps to a possible fifth edition, but
>> that effort will require significant resources.
>>
>> 1) The printed and free online PDF of the VTK textbook is the gold
>> standard for this edition. The online PDF is a low-resolution version
>> that exhibits some difficulty converting equations. It is available as
>> one, downloadable PDF with no active links. FrameMaker produces the
>> PDF  from FrameMaker files capable of producing different PDF
>> resolutions. Editing the FrameMaker files requires a license from
>> Adobe. It is unlikely the VTK community will have access to these
>> proprietary files. Major contributors include Will Schroeder and other
>> Kitware employees. See: https://www.vtk.org/vtk-textbook/
>> <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.vtk.org%2Fvtk-textbook%2F&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=4%2BLcfOxKTaqRmtJDqN1a4sdZqrA8J%2FIVy5MlHWKOBzs%3D&reserved=0>
>>
>> 2)  A VTK latex version of the VTK textbook is a work-in-progress
>> effort. The goal is to produce a Latex version populated with links to
>> figures, references, equations, examples, etc. The PDF version is
>> downloadable as a single file.  The figures that exist as VTK Examples
>> are linked to the nightly output of the regression testing. Once this
>> work is stable, the user community will be able to push merge requests
>> to fix problems with the Latex. The major contributor is Andrew
>> Maclean. You can follow the progress here:
>> https://lorensen.github.io/VTKExamples/site/VTKBookLaTex/VTKTextBook/
>> <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Florensen.github.io%2FVTKExamples%2Fsite%2FVTKBookLaTex%2FVTKTextBook%2F&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=J2bVg4dCWh%2FNKtfzWzDhKmwPVIXOyvsR8%2Bzawyl9jV0%3D&reserved=0>
>>
>> 3) A markdown version of the VTK textbook is also a work-in-progress.
>> The goal is to produce an interactive, platform friendly version of
>> the book. The entire text is available on as a Chapter by Chapter
>> website. The figures that exist as VTK Examples are linked to the
>> nightly output of the regression testing. Once this work is stable,
>> the user community will be able to push merge requests to fix problems
>> with the markdown. The major contributors are Bill Lorensen and
>> Bernhard Meehan. Bernhard has produced Latex for all 100 equations in
>> the text.  You can follow the progress here:
>> https://lorensen.github.io/VTKExamples/site/VTKBook/Chapter1/
>> <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Florensen.github.io%2FVTKExamples%2Fsite%2FVTKBook%2FChapter1%2F&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=PH6jRr02nztbkBUMyQ5AVzpYK%2FBc62BLrP7Ap2xJKEk%3D&reserved=0>
>> and
>> other chapters.
>>
>> When the Latex and Markdown versions are more complete, we will ask
>> the user community to help proofread the new versions.
>>
>>
>> Bill
>> --
>> Unpaid intern in BillsParadise at noware dot com
>> _______________________________________________
>> Powered by www.kitware.com
>> <https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.kitware.com&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=iUjIjW86auur8ciI5bkVZY8MOEYf7ds1IBpQbopOZes%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%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=Kmjf1JgsouMcHUpD0sgW6%2BmJvC05JAUtVsaDXy8V9tM%3D&reserved=0>
>>
>> Search the list archives at: http://markmail.org/search/?q=vtk-developers
>> <https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fmarkmail.org%2Fsearch%2F%3Fq%3Dvtk-developers&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=urYcS95top7ANz6c8IeLFvnPmG3JqyAbe4X%2BJj0hQkE%3D&reserved=0>
>>
>> Follow this link to subscribe/unsubscribe:
>> https://vtk.org/mailman/listinfo/vtk-developers
>> <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fvtk.org%2Fmailman%2Flistinfo%2Fvtk-developers&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=DhjKUui1dgFU1Z8kMtrAPkbixboZPnOpWI8FQLtIYgg%3D&reserved=0>
>>
>>
>>
>> _______________________________________________
>> Powered by www.kitware.com
>> <https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.kitware.com&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=iUjIjW86auur8ciI5bkVZY8MOEYf7ds1IBpQbopOZes%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%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=Kmjf1JgsouMcHUpD0sgW6%2BmJvC05JAUtVsaDXy8V9tM%3D&reserved=0>
>>
>> Search the list archives at: http://markmail.org/search/?q=vtk-developers
>> <https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fmarkmail.org%2Fsearch%2F%3Fq%3Dvtk-developers&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=urYcS95top7ANz6c8IeLFvnPmG3JqyAbe4X%2BJj0hQkE%3D&reserved=0>
>>
>> Follow this link to subscribe/unsubscribe:
>> https://vtk.org/mailman/listinfo/vtk-developers
>> <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fvtk.org%2Fmailman%2Flistinfo%2Fvtk-developers&data=02%7C01%7Classo%40queensu.ca%7C0ca67e18c6df4c3973aa08d5aa910e8c%7Cd61ecb3b38b142d582c4efb2838b925c%7C1%7C0%7C636602462358661535&sdata=DhjKUui1dgFU1Z8kMtrAPkbixboZPnOpWI8FQLtIYgg%3D&reserved=0>
>>
>>
>> _______________________________________________
>> Powered by www.kitware.com
>>
>> Visit other Kitware open-source projects at
>> http://www.kitware.com/opensource/opensource.html
>>
>> Search the list archives at: http://markmail.org/search/?q=vtk-developers
>>
>> Follow this link to subscribe/unsubscribe:
>> https://vtk.org/mailman/listinfo/vtk-developers
>>
>>
>>
>
>
> --
> Unpaid intern in BillsParadise at noware dot com
>

-- 
___________________________________________
Andrew J. P. Maclean

___________________________________________
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://vtk.org/pipermail/vtk-developers/attachments/20180426/5137d700/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 114921 bytes
Desc: not available
URL: <https://vtk.org/pipermail/vtk-developers/attachments/20180426/5137d700/attachment-0001.png>