[vtkusers] [vtk-developers] VTKBook Strawman - Chapter 3

[Bill Lorensen]

Thanks for the feedback!

On Fri, Apr 6, 2018, 9:15 AM Elvis Stansvik <elvis.stansvik at orexplore.com>
wrote:

> Looks great on my phone, including the mathjax rendered equations (see
> attached screenshot).
>
> This will be great material for my morning bus rides to work :)
>
> I also think markdown embedded latex is the way to go, instead of full-out
> latex.
>
> Elvis
>
> Den 6 apr. 2018 4:11 em skrev "Bill Lorensen" <bill.lorensen at gmail.com>:
>
>> More progress.I found a great online tool to generate Latex formulas.
>> With no previous Latex experience,I was able to generate all of the
>> equations for Chapter 3. I can embed Latex in the markdown. The
>> equations are rendered by MathJax.
>>
>> Here is the online website:
>> http://www.hostmath.com/
>>
>> and here is the updated Chapter 3:
>>
>> https://lorensen.github.io/VTKExamples/site/VTKBook/Chapter3/
>>
>> Bill
>>
>> On Fri, Apr 6, 2018 at 6:28 AM, David Cole via vtk-developers
>> <vtk-developers at vtk.org> wrote:
>> > "I ignore whether Markdown/reStrucuredText support for
>> > tools to have proper printed texts is likely to be improved."
>> >
>> > I have become a big fan of "print to pdf using the Chrome browser" to
>> > get a printed copy of web content these days. It's actually not a bad
>> > way to go if you don't need to refer to page numbers within the text.
>> >
>> >
>> > And now, this is just my opinion, so take with yet another grain of
>> salt:
>> >
>> > The available "writer pool" for LaTeX is far far smaller than that for
>> > markdown. If the math stuff must be in LaTeX, I'd very strongly prefer
>> > to see it as embedded chunks of LaTeX than have the whole thing be in
>> > LaTeX.
>> >
>> >
>> > Nice work, as usual Bill.
>> >
>> >
>> > Thanks,
>> > David C.
>> >
>> >
>> >
>> > On Fri, Apr 6, 2018 at 2:20 AM, Jon Haitz Legarreta
>> > <jhlegarreta at vicomtech.org> wrote:
>> >> Bill, Andrew, simply brilliant.
>> >>
>> >> I've spot some parts in the Chapters 3 and 6 strawmans that were
>> >> already mentioned by you and Todd whose transition has some errors
>> >> (links that are missing, missing cross-reference links to VTK classes,
>> >> examples or bibliography, etc.).
>> >>
>> >> How can we contribute to fix them? Are you still working on the
>> >> transition tools to improve the output, or you want us to manually try
>> >> to fix them?
>> >>
>> >> I can help with/do all the Maths in LaTeX Bill. However, if the tool
>> >> you found works or the transition will be automatic, I do not see
>> >> where to help at this stage. Please, let me know.
>> >>
>> >> Otherwise, it's looking awesome.
>> >>
>> >> As for the LaTeX vs. Markdown/reStrucuredText discussion:
>> >>
>> >> I've contributed with some patches to the ITK SW Guide written in
>> >> LaTeX. I guess at the time it was written Markdown and reStrucuredText
>> >> were not available, so I think the choice was fair.
>> >>
>> >> Having said that, I admit that the learning curve for LaTeX may be
>> >> higher than that for Markdown or reStrucuredText. The latter are
>> >> tailored for web navigation, which is most people expect. And times
>> >> have changed. I ignore whether Markdown/reStrucuredText support for
>> >> tools to have proper printed texts is likely to be improved.
>> >>
>> >> I guess the ITK SW Guide requiring to be compiled (both the examples
>> >> to generate the figures and LaTeX itself) is not a downside, since VTK
>> >> Cxx examples used in this book need so.
>> >>
>> >> I guess having a first version for both cases (LaTeX and
>> >> Markdown/reStrucuredText) is somehow costly at the beginning.
>> >> Maintaining/sync'ing them once that is done every time there is a
>> >> change may not effortless also. But that may be the price to pay.
>> >>
>> >> The ITK SW Guide keeps being maintained. I ignore whether the ITK
>> >> folks at Kitware have considered to transition to Markdown or
>> >> reStrucuredText.
>> >>
>> >> JON HAITZ
>> >>
>> >> --
>> >>
>> >>
>> >> On 6 April 2018 at 01:05, Todd via vtk-developers
>> >> <vtk-developers at vtk.org> wrote:
>> >>> Fantastic. I think Latex is definitely the way to go, although I'm no
>> expert
>> >>> in writing it.
>> >>>
>> >>> _______________________________________________
>> >>> 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
>> >>>
>> >>>
>> >> _______________________________________________
>> >> 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
>> >>
>> > _______________________________________________
>> > 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
>> _______________________________________________
>> 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
>>
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://vtk.org/pipermail/vtkusers/attachments/20180406/7e00e4c9/attachment.html>