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

[Bill Lorensen]

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