Forum: Ruby Full Ruport Book manuscripts now on Github

Announcement (2017-05-07): www.ruby-forum.com is now read-only since I unfortunately do not have the time to support and maintain the forum any more. Please see rubyonrails.org/community and ruby-lang.org/en/community for other Rails- und Ruby-related community platforms.
31e038e4e9330f6c75ccfd1fca8010ee?d=identicon&s=25 Gregory Brown (Guest)
on 2009-02-05 23:52
(Received via mailing list)
Hi folks,

I'm happy to announce that my friend Chenoa Siegenthaler has converted
the entire Ruport Book to asciidoc, and that the sources are now
available on github.

http://github.com/ruport/book

The bookcan be build through Asciidoc to produce HTML and PDF, though
build instructions will need to wait until another day.  But in the
mean time, people are welcome to start contributing fixes and
otherwise helping out.   I will likely update the book when Ruport 2
rolls around, but the conversion of the sources to asciidoc represents
the next step in fully freeing the Ruport book up for community
contributions.  It is licensed under the Creative Commons
Attribution-Sharealike license[0], so you are fairly unrestricted in
what you can do with it.  Please enjoy, and feel free to discuss any
suggested changes or ideas you might have on the Ruport mailing list:
http://list.rubyreports.org

Though most of you are not likely to know Chenoa, I have been training
her in Ruby programming, and it's safe to say that this won't be her
only contribution to the Ruby community in general.  So a big thanks
to her, and please enjoy the raw manuscript.

-greg

[0] http://creativecommons.org/licenses/by-sa/3.0/
703fbc991fd63e0e1db54dca9ea31b53?d=identicon&s=25 Robert Dober (Guest)
on 2009-02-06 12:10
(Received via mailing list)
Attachment: rake_forword.tbz2 (3 KB)
On Thu, Feb 5, 2009 at 11:51 PM, Gregory Brown
<gregory.t.brown@gmail.com> wrote:
> mean time, people are welcome to start contributing fixes and
> her in Ruby programming, and it's safe to say that this won't be her
> "Ruby Best Practices"  Book now in O'Reilly Roughcuts:
> http://rubybestpractices.com
>

Hmm I got some problems but with the adapted rakefile and new
manuscript/forward.txt I get 98 pages and 15 chapters, still having
some errors though.

rake or rake  config

ok

rake build

in
/home/robert/docs/Ruby/ruport-book-a793237e2bcf8134e5e2d51a0b8cec7a650cfd1c)
Build the listings...
XSLT stylesheets DocBook -  LaTeX 2e (0.2.9-2)
===================================================
Build book.pdf
This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6)
 %&-line parsing enabled.
entering extended mode
This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6)
 %&-line parsing enabled.
entering extended mode
This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6)
 %&-line parsing enabled.
entering extended mode
Image '/Users/chenoa/devel/ruport_book/manuscript/images/tattle.png' not
found
Image
'/Users/chenoa/devel/ruport_book/manuscript/images/payr_intro_screen1.png'
not found
Image
'/Users/chenoa/devel/ruport_book/manuscript/images/payr_intro_screen2.png'
not found
Image
'/Users/chenoa/devel/ruport_book/manuscript/images/payr_intro_screen3.png'
not found
Image
'/Users/chenoa/devel/ruport_book/manuscript/images/payr_formatting_screen1.png'
not found
Image
'/Users/chenoa/devel/ruport_book/manuscript/images/weekly_report.png'
not found
Image '/Users/chenoa/devel/ruport_book/manuscript/images/simple.png' not
found
Image '/Users/chenoa/devel/ruport_book/manuscript/images/header.png' not
found
Image '/Users/chenoa/devel/ruport_book/manuscript/images/foo.png' not
found
Image '/Users/chenoa/devel/ruport_book/manuscript/images/bar.png' not
found
'book.pdf' successfully built
31e038e4e9330f6c75ccfd1fca8010ee?d=identicon&s=25 Gregory Brown (Guest)
on 2009-02-06 14:51
(Received via mailing list)
On Fri, Feb 6, 2009 at 6:08 AM, Robert Dober <robert.dober@gmail.com>
wrote:

> Hmm I got some problems but with the adapted rakefile and new
> manuscript/forward.txt I get 98 pages and 15 chapters, still having
> some errors though.

Looks like we hardcoded the path for image generation.  I won't be
able to look at this right away, but I'll check it out when I get a
chance.

Thanks for reporting this issue Robert.

-greg
8f6f95c4bd64d5f10dfddfdcd03c19d6?d=identicon&s=25 Rick Denatale (rdenatale)
on 2009-02-06 22:47
(Received via mailing list)
On Fri, Feb 6, 2009 at 8:50 AM, Gregory Brown
<gregory.t.brown@gmail.com>wrote:

>
> Thanks for reporting this issue Robert.
>

Hmmm, I tried myself on OS X Leopard, figuring I might be able to debug
the
problem.

First I installed ascii doc using ports.

Then I discovered that I don't have dblatex which isn't available in
macports.  I think that fink (which I've never used, and have no idea
how it
plays with macports) has it, but I wasn't interested enough to pursue
it.

Oh well.

--
Rick DeNatale

Blog: http://talklikeaduck.denhaven2.com/
Twitter: http://twitter.com/RickDeNatale
31e038e4e9330f6c75ccfd1fca8010ee?d=identicon&s=25 Gregory Brown (Guest)
on 2009-02-06 23:04
(Received via mailing list)
On Fri, Feb 6, 2009 at 4:46 PM, Rick DeNatale <rick.denatale@gmail.com>
wrote:

> Hmmm, I tried myself on OS X Leopard, figuring I might be able to debug the
> problem.

Thanks for checking it out.

I know what's wrong, I just haven't had a chance to fix it.  Currently
the images are prefaced with a full path to a directory in the
manuscript... we need to make them relative.   I'll get to it when I
can.

As far as I know, the PDF will still build, it just might omit some of
the figures.

> Then I discovered that I don't have dblatex which isn't available in
> macports.  I think that fink (which I've never used, and have no idea how it
> plays with macports) has it, but I wasn't interested enough to pursue it.

I think I just built dblatex from source, after grabbing asciidoc
using macports.
31e038e4e9330f6c75ccfd1fca8010ee?d=identicon&s=25 Gregory Brown (Guest)
on 2009-02-06 23:05
(Received via mailing list)
On Fri, Feb 6, 2009 at 5:00 PM, Gregory Brown
<gregory.t.brown@gmail.com> wrote:
> On Fri, Feb 6, 2009 at 4:46 PM, Rick DeNatale <rick.denatale@gmail.com> wrote:

> I think I just built dblatex from source, after grabbing asciidoc
> using macports.

Sorry, that was pretty ambiguous.  I meant, I installed asciidoc
through macports and manually built dblatex.

-greg
703fbc991fd63e0e1db54dca9ea31b53?d=identicon&s=25 Robert Dober (Guest)
on 2009-02-06 23:19
(Received via mailing list)
On Fri, Feb 6, 2009 at 11:02 PM, Gregory Brown
<gregory.t.brown@gmail.com> wrote:
>
> As far as I know, the PDF will still build, it just might omit some of
> the figures.
>
98 pages, affirmative, I had not had any time looking into it though :(
8f6f95c4bd64d5f10dfddfdcd03c19d6?d=identicon&s=25 Rick Denatale (rdenatale)
on 2009-02-08 19:53
(Received via mailing list)
On Fri, Feb 6, 2009 at 5:15 PM, Robert Dober <robert.dober@gmail.com>
wrote:

> On Fri, Feb 6, 2009 at 11:02 PM, Gregory Brown
> <gregory.t.brown@gmail.com> wrote:
> >
> > As far as I know, the PDF will still build, it just might omit some of
> > the figures.
> >
> 98 pages, affirmative, I had not had any time looking into it though :(
>

I got it to build, with images, and it's 103 pages.

That was a manual process though, I replaced all of the path prefixes
for
the images in the manuscript/*.txt files with a hard-coded path prefix
which
works for my machine.

It looks like there's some process which generates the manuscript/*.txt
files from the textile files, which we don't have.  At least that's my
guess.

--
Rick DeNatale

Blog: http://talklikeaduck.denhaven2.com/
Twitter: http://twitter.com/RickDeNatale
8f6f95c4bd64d5f10dfddfdcd03c19d6?d=identicon&s=25 Rick Denatale (rdenatale)
on 2009-02-08 20:44
(Received via mailing list)
On Sun, Feb 8, 2009 at 1:51 PM, Rick DeNatale
<rick.denatale@gmail.com>wrote:

> guess
>

As a follow-up, I forked the git hub repository and added two tasks to
the
rake_file

rake fix_images will convert any hard coded image links in the
manuscript
directory so that they
   work on your local machine.  They'll still be hard coded, but they
will
be hard coded just for you!

rake convert_all will run ascii doc on all of the manuscript/*.txt files
rather than requiring each one
  to be passed in as a command line arg.

http://github.com/rubyredrick/book/tree/master

Greg, feel free to pull these changes if you're happy with them.

--
Rick DeNatale

Blog: http://talklikeaduck.denhaven2.com/
Twitter: http://twitter.com/RickDeNatale
31e038e4e9330f6c75ccfd1fca8010ee?d=identicon&s=25 Gregory Brown (Guest)
on 2009-02-08 22:39
(Received via mailing list)
On Sun, Feb 8, 2009 at 2:42 PM, Rick DeNatale <rick.denatale@gmail.com>
wrote:
> On Sun, Feb 8, 2009 at 1:51 PM, Rick DeNatale <rick.denatale@gmail.com>wrote:

>  to be passed in as a command line arg.
>
> http://github.com/rubyredrick/book/tree/master
>
> Greg, feel free to pull these changes if you're happy with them.

Good stuff, I'll definitely pull in convert_all.   I might try to find
a more suitable fix for the image stuff.

Thanks for looking into this.  On a completely unrelated note: You
might want to rename your fork ruport-book or something, for less
ambiguity.  I guess my trick of github.com/ruport/book has its
disadvantages.  :-/

-greg
8f6f95c4bd64d5f10dfddfdcd03c19d6?d=identicon&s=25 Rick Denatale (rdenatale)
on 2009-02-09 00:51
(Received via mailing list)
On Sun, Feb 8, 2009 at 4:38 PM, Gregory Brown
<gregory.t.brown@gmail.com>wrote:

> > directory so that they
>
> Good stuff, I'll definitely pull in convert_all.   I might try to find
> a more suitable fix for the image stuff.
>
> Thanks for looking into this.  On a completely unrelated note: You
> might want to rename your fork ruport-book or something, for less
> ambiguity.  I guess my trick of github.com/ruport/book has its
> disadvantages.  :-/
>

Okay the url is now
http://github.com/rubyredrick/ruport-book/tree/masterand the clone url
is now: git://
github.com/rubyredrick/ruport-book.git

Anyone who cloned it be warned, you'll want to do something like

  git remote rm origin
  git remote add origin git://github.com/rubyredrick/ruport-book.git

--
Rick DeNatale

Blog: http://talklikeaduck.denhaven2.com/
Twitter: http://twitter.com/RickDeNatale
703fbc991fd63e0e1db54dca9ea31b53?d=identicon&s=25 Robert Dober (Guest)
on 2009-02-09 01:11
(Received via mailing list)
On Mon, Feb 9, 2009 at 12:49 AM, Rick DeNatale <rick.denatale@gmail.com>
wrote:
>  git remote add origin git://github.com/rubyredrick/ruport-book.git
>
Great job Rick! Just one question, would this patch for the Rakefile be
useful?
------------------- 8< ---------------------
--- Rakefile  2009-02-09 01:03:27.000000000 +0100
+++ Rakefile.new  2009-02-09 01:09:37.000000000 +0100
@@ -1,6 +1,6 @@
 task :default => [:build]

-task :build do
+task :build => :convert_all do
   sh "export PATH=/opt/local/bin:$PATH"
   sh "dblatex xml/book.xml -o book.pdf"
   sh "open book.pdf"
@@ -12,7 +12,7 @@
   sh "asciidoc -d book -b docbook -o xml/ch_#{basefile} -s #{ARGV[1]}"
 end

-task :convert_all do
+task :convert_all  => :fix_images do
   targetDir = File.join(File.dirname(__FILE__), 'xml')
   sh "export PATH=/opt/local/bin:$PATH"
   FileList[File.join(File.dirname(__FILE__), 'manuscript',
'*.txt')].each do |src|
---------------- >8 ----------------------------

Cheers
Robert
31e038e4e9330f6c75ccfd1fca8010ee?d=identicon&s=25 Gregory Brown (Guest)
on 2009-02-09 01:19
(Received via mailing list)
On Sun, Feb 8, 2009 at 7:09 PM, Robert Dober <robert.dober@gmail.com>
wrote:

> Great job Rick! Just one question, would this patch for the Rakefile be useful?

Yeah I plan to do that :)

-greg
8f6f95c4bd64d5f10dfddfdcd03c19d6?d=identicon&s=25 Rick Denatale (rdenatale)
on 2009-02-09 03:44
(Received via mailing list)
On Sun, Feb 8, 2009 at 7:18 PM, Gregory Brown
<gregory.t.brown@gmail.com>wrote:

> On Sun, Feb 8, 2009 at 7:09 PM, Robert Dober <robert.dober@gmail.com>
> wrote:
>
> > Great job Rick! Just one question, would this patch for the Rakefile be
> useful?
>
> Yeah I plan to do that :)
>

I actually had it that way at first, but decided to not change too much
at
once.

--
Rick DeNatale

Blog: http://talklikeaduck.denhaven2.com/
Twitter: http://twitter.com/RickDeNatale
This topic is locked and can not be replied to.