[vtk-developers] VTKBook Strawman - Chapter 3

[Elvis Stansvik]

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/vtk-developers/attachments/20180406/d4d4b1ab/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot_20180406-181207.png
Type: image/png
Size: 167660 bytes
Desc: not available
URL: <https://vtk.org/pipermail/vtk-developers/attachments/20180406/d4d4b1ab/attachment-0001.png>