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

[David Cole]

"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
>