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

Sun Apr 8 02:04:09 EDT 2018

Hi All,

It looks like it is also possible to get a pdf version of the book. There
is still a lot to sort out but here is a first attempt. I can take the
markdown files that Bill is producing and use them which is great.

Note that the hyperlinks (inside and outside the document) seem to work Ok.
I haven't indexed anything yet and obviously the illustrations will need
placing correctly.

Still have to figure out how to get an image at top left of the chapter
heading.

So setting up the environment is ongoing.

Regards
   Andrew

On Sat, Apr 7, 2018 at 9:43 AM, Todd <nztoddler at yahoo.com> wrote:

> That looks great. It's nice to see the formula variables formatted
> properly in the text. I agree that LaTeX embedded in markdown is a good
> choice!
>
>
> On 7 Apr 2018 2:11 a.m., Bill Lorensen <bill.lorensen at gmail.com> wrote:
>
> 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
>
> Please keep messages on-topic and check the VTK FAQ at:
> http://www.vtk.org/Wiki/VTK_FAQ
>
> Search the list archives at: http://markmail.org/search/?q=vtkusers
>
> Follow this link to subscribe/unsubscribe:
> https://vtk.org/mailman/listinfo/vtkusers
>
>
>

-- 
___________________________________________
Andrew J. P. Maclean

___________________________________________
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://vtk.org/pipermail/vtkusers/attachments/20180408/936081f8/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: VTKTextBook.pdf
Type: application/pdf
Size: 380878 bytes
Desc: not available
URL: <https://vtk.org/pipermail/vtkusers/attachments/20180408/936081f8/attachment-0001.pdf>