Matt-
How are we doing with the book? Do you have a list
of volunteers and the chapters they are planning to
work on?
I'm getting started on the two I'm covering but I
think we need to sort out what's what as we
approach the end of January. There are still a
couple of weeks to go but I haven't see a lot of
new addtions to the PDL book git.
At the least we need a head count of what is
actually being worked. If necessary, we can get
a fallback plan to cover some sort of partial
release (which I had hoped to avoid). Have you
put up the contents of the previous book work
on the git. Even a re-work of those chapters
with some of the new work would be a *huge*
improvement to go with PDL-2.4.10.
Thanks,
Chris
On 1/5/2012 10:44 AM, Matthew Kenworthy wrote:
Fantastic! Pull down the latest book and start writing :) Any small,
completed sections will help!
Cheers,
Matt
On Thu, Jan 5, 2012 at 3:44 AM, chm<[email protected]> wrote:
Matt-
I volunteer to do a chapter on the 3D graphics
and a chapter/intro/tutorial on the PDL shell(s).
--Chris
On 10/17/2011 9:41 PM, Karl Glazebrook wrote:
Hi Matt,
Sounds good, I volunteer to do 1 chapter if others also do.
How about we collect volunteers here, and they you marshall them?
I agree that sounds a lot easier than latex.
How did you make the PDF?
-Karl
Sent from an iProduct
On Oct 18, 2011, at 12:21 AM, Matthew Kenworthy<kenworthy@strw.**
leidenuniv.nl<[email protected]>> wrote:
Hi Chris, Karl, and other PDL Book interested people:
On Fri, Sep 30, 2011 at 5:17 PM, Chris
Marshall<devel.chm.01@gmail.**com<[email protected]>>
wrote:
Hi Matt-
How are things going with the PDL book "project"
as far as status, plans, working files, or other
information? Would setting up a git folder at
sf.net help with coordination and contributions?
A git folder would be a good idea :)
Here were my thoughts on PDL Books and Tutorials -
In order to write and edit PDL documentation, it would be good to have
a simple format that everyone could edit easily and see it updated in
a timely fashion, but that it could be exported to something nicer as
a printable format in a PDF, such as the LaTeX output of the original
PDL Book.
To this end, I decided to try rewriting the PDL Book in POD.
I've found out that this works surprisingly well, because:
1) Writing in POD means that it is completely available and searchable
in the PDL help system
2) There's no maintaining a separate documentation repository (it
lives with PDL)
3) It can be cross-linked in with the PDL core documentation
To test this out, I converted the PDL Book Chapter 3, which is image
intensive chapters in the book, in order to see what the output would
be like in HTML and PDF.
The original POD documentation:
http://www.strw.leidenuniv.nl/**~kenworthy/pdlpod/PDL.Tut.**
PGPLOT/PDL.Tut.PGPLOT.pod<http://www.strw.leidenuniv.nl/~kenworthy/pdlpod/PDL.Tut.PGPLOT/PDL.Tut.PGPLOT.pod>
Converted to HTML:
http://www.strw.leidenuniv.nl/**~kenworthy/pdlpod/PDL.Tut.**
PGPLOT/PDL.Tut.PGPLOT.html<http://www.strw.leidenuniv.nl/~kenworthy/pdlpod/PDL.Tut.PGPLOT/PDL.Tut.PGPLOT.html>
....and exported as PDF:
http://www.strw.leidenuniv.nl/**~kenworthy/pdlpod/PDL.Tut.**
PGPLOT/test.pdf<http://www.strw.leidenuniv.nl/~kenworthy/pdlpod/PDL.Tut.PGPLOT/test.pdf>
So, what does this mean?
Ideally, it would be good to see a PDL Book, a set of PDL Tutorials
and a PDL Reference (mostly made up of the PDL function documentation)
which factor in the hard work done on the earlier separate texts, so
that we can all point new users to a given help page from within PDL.
The main work is doing the control code mangling, the conversion of
the images to PNG and checking that the new texts scan well. I can
take the lead on organisation, but I don't have that much time to do
conversions all by myself - if two or three people are willing to work
on converting a chapter at a time, we could pull something together
for a December/January release.
Okay, have a look at the PDF if nothing else, and let me know what you
think.
Cheers,
Matt
--
Matthew Kenworthy / Assistant Professor / Leiden Observatory
Niels Bohrweg 2 (#463) / P.O. Box 9513 / 2300 RA Leiden / NL
-----
No virus found in this message.
Checked by AVG - www.avg.com
Version: 10.0.1411 / Virus Database: 1522/3957 - Release Date: 10/17/11
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
