rabbit 0.9.2 → 0.9.3

data/doc/en/install/homebrew.rd

@@ -0,0 +1,196 @@
+---
+layout: en
+title: Install with Homebrew
+---
+== How to install Rabbit with Homebrew on Mac OS X
+
+This document describes how to install Rabbit with Homebrew and RubyGems on Mac OS X.
+
+=== Requirements
+
+* An Intel CPU
+* OS X Leopard or higher
+* Xcode with X11
+
+=== Install Homebrew
+
+ $ ruby -e "$(curl -fsS http://gist.github.com/raw/323731/install_homebrew.rb)"
+
+Then add /usr/local/bin to your PATH.
+
+=== Install Softwares Rabbit Needs (brew install)
+
+Change files in /usr/local/Library/Formula/*.rb as follows.
+Then exec "brew install".
+
+==== /usr/local/Library/Formula/pango.rb
+
+  require 'formula'
+
+  class Pango < Formula
+    homepage 'http://www.pango.org/'
+    url 'http://ftp.gnome.org/pub/GNOME/sources/pango/1.28/pango-1.28.4.tar.bz2'
+    sha256 '7eb035bcc10dd01569a214d5e2bc3437de95d9ac1cfa9f50035a687c45f05a9f'
+
+    depends_on 'pkg-config' => :build
+    depends_on 'glib'
+
+    fails_with_llvm "Undefined symbols when linking", :build => "2326"
+
+    if MacOS.leopard?
+      depends_on 'fontconfig' # Leopard's fontconfig is too old.
+      depends_on 'cairo' # Leopard doesn't come with Cairo.
+    end
+
+    def install
+      system "./configure", "--prefix=#{prefix}", "--without-x",
+                            "--enable-static",
+                            "--disable-introspection",
+                            "--x-include=#{prefix}/include",
+                            "--x-lib=#{prefix}/lib"
+      system "make install"
+    end
+  end
+
+==== /usr/local/Library/Formula/cairo.rb
+
+  require 'formula'
+
+  class Cairo < Formula
+    homepage 'http://cairographics.org/'
+    url 'http://www.cairographics.org/releases/cairo-1.10.2.tar.gz'
+    sha1 'ccce5ae03f99c505db97c286a0c9a90a926d3c6e'
+
+    depends_on 'pkg-config' => :build
+    depends_on 'pixman'
+
+    keg_only :provided_by_osx,
+              "The Cairo provided by Leopard is too old for newer software to link against."
+
+    fails_with_llvm "Gives an LLVM ERROR with Xcode 4 on some CPUs"
+
+    def install
+      system "./configure", "--disable-dependency-tracking",
+                            "--prefix=#{prefix}",
+                            "--without-x",
+                            "--enable-quartz",
+                            "--enable-quartz-font",
+                            "--enable-quartz-image",
+                            "--disable-xlib",
+                            "--disable-xlib-xrender"
+
+      system "make install"
+    end
+  end
+
+==== /usr/local/Library/Formula/gtk+.rb
+
+  require 'formula'
+
+  class Gtkx < Formula
+    homepage 'http://www.gtk.org/'
+    url 'http://ftp.gnome.org/pub/gnome/sources/gtk+/2.24/gtk+-2.24.4.tar.bz2'
+    sha256 '7d3033ad83647079977466d3e8f1a7533f47abd5cc693f01b8797ff43dd407a5'
+
+    depends_on 'pkg-config' => :build
+    depends_on 'glib'
+    depends_on 'jpeg'
+    depends_on 'libtiff'
+    depends_on 'gdk-pixbuf'
+
+    # Used by pango, but keg-only, so needs to be added to
+    # the flags for gtk+ explicitly.
+    depends_on 'cairo' if MacOS.leopard?
+
+    depends_on 'pango'
+    depends_on 'jasper' => :optional
+    depends_on 'atk' => :optional
+
+    fails_with_llvm "Undefined symbols when linking", :build => "2326"
+
+    def install
+      system "./configure", "--disable-debug", "--disable-dependency-tracking",
+                            "--prefix=#{prefix}",
+                            "--disable-glibtest",
+                            "--with-gdktarget=quartz"
+      system "make install"
+    end
+
+    def test
+      system "gtk-demo"
+    end
+  end
+
+=== /usr/local/Library/Formula/poppler.rb
+
+  require 'formula'
+
+  class PopplerData < Formula
+    url 'http://poppler.freedesktop.org/poppler-data-0.4.4.tar.gz'
+    md5 'f3a1afa9218386b50ffd262c00b35b31'
+  end
+
+  class Poppler < Formula
+    url 'http://poppler.freedesktop.org/poppler-0.16.6.tar.gz'
+    homepage 'http://poppler.freedesktop.org/'
+    md5 '592a564fb7075a845f75321ed6425424'
+
+    depends_on 'pkg-config' => :build
+    depends_on "qt" if ARGV.include? "--with-qt4"
+
+    def options
+      [
+        ["--with-qt4", "Include Qt4 support (which compiles all of Qt4!)"],
+        ["--enable-xpdf-headers", "Also install XPDF headers."]
+      ]
+    end
+
+    def install
+      ENV.x11 # For Fontconfig headers
+
+      if ARGV.include? "--with-qt4"
+        ENV['POPPLER_QT4_CFLAGS'] = `pkg-config QtCore QtGui --libs`.chomp.strip
+        ENV.append 'LDFLAGS', "-Wl,-F#{HOMEBREW_PREFIX}/lib"
+      end
+
+      args = ["--disable-dependency-tracking", "--prefix=#{prefix}"]
+      args << "--disable-poppler-qt4" unless ARGV.include? "--with-qt4"
+      args << "--enable-xpdf-headers" if ARGV.include? "--enable-xpdf-headers"
+      args << "--enable-cairo-output"
+      args << "--enable-poppler-glib"
+      args << "--disable-gtk-test"
+
+      system "./configure", *args
+      system "make install"
+
+      # Install poppler font data.
+      PopplerData.new.brew do
+        system "make install prefix=#{prefix}"
+      end
+    end
+  end
+
+==== Exec brew install and brew link
+
+  $ brew install cairo
+  $ brew link cairo
+  $ brew install pango
+  $ brew install gtk+
+  $ brew install poppler
+
+=== Install Softwares Rabbit Needs (gem install)
+
+Exec gem install.
+
+  $ sudo gem install pango
+  $ sudo gem install cairo
+  $ sudo gem install gtk2
+  $ sudo gem install gdk_pixbuf2
+  $ sudo gem install poppler
+  $ sudo gem install hikidoc # If you use Wiki notation.
+
+=== Install Rabbit
+
+Exec gem install.
+
+  $ sudo gem install rabbit

data/doc/en/install/index.rd

@@ -0,0 +1,63 @@
+---
+layout: en
+title: Install
+---
+== About how to install
+
+Many package system supports Rabbit. So it's easy to
+install Rabbit. You can use RubyGems or package system on
+your platform.
+
+== Hot to install by RubyGems
+
+  % gem install rabbit
+
+== How to install on Debian GNU/Linux
+
+  % sudo aptitude install -y rabbit
+
+== How to install on Ubuntu
+
+  % sudo aptitude install -y rabbit
+
+== How to install on Gentoo Linux
+
+  % sudo env ACCEPT_KEYWORDS=~x86 FEATURES="digest" emerge rabbit
+
+== How to install on NetBSD (or pkgsrc ready platform)
+
+  % sudo pkg_add ruby18-rabbit
+
+or
+
+  % sudo pkg_add ruby19-rabbit
+
+== How to install on FreeBSD
+
+  % sudo portupgrade -NRr rabbit
+
+== How to install with MacPorts on Mac OS X
+
+See ((<macports.rd/Install with MacPorts>)).
+
+== How to install with Homebrew on Mac OS X
+
+See ((<homebrew.rd/Install with Homebrew>)).
+
+== How to install on Windows.
+
+See ((<windows.rd/Install on Windows>)).
+
+== How to install from tar.gz
+
+You just download the latest Rabbit from
+((<URL:http://rabbit-shockers.org/download/rabbit.tar.gz>))
+and run setup.rb. The URL always specifies the latest Rabbit
+archive.
+
+  % mkdir tmp
+  % cd tmp
+  % wget http://rabbit-shockers.org/download/rabbit.tar.gz
+  % tar xvzf rabbit.tar.gz
+  % cd rabbit-*
+  % sudo ruby setup.rb

data/doc/en/install/macports.rd

@@ -0,0 +1,77 @@
+---
+layout: en
+title: Install with MacPorts
+---
+== How to install Rabbit with MacPorts on Mac OS X
+
+This document describes how to install Rabbit with MacPorts and how to use
+Rabbit on Mac OS X.
+
+=== Requirements
+
+The following programs are needed.
+
+* Xcode Tools (from Xcode Tools DVD or ADC)
+* X11 (from Mac OS X System DVD)
+
+Remember to select "X11 SDK" when installing the Xcode Tools.
+
+=== Install MacPorts
+
+see ((<URL:http://www.macports.org/>)).
+
+=== installing Rabbit
+
+You might want to do the following to update information for
+required ports.
+
+  ~% sudo port sync
+
+The following command will install rabbit and its dependencies.
+
+  ~% sudo port install rb-rabbit
+
+You can install these ports to make rabbit even better.
+
+* Ruby-GetText-Package (rb-gettext) - enable I18N message catalogs
+* net/irc (rb-net-irc) - rabbirc requires net/irc
+
+  ~% sudo port install rb-gettext
+  ~% sudo port install rb-net-irc
+
+==== Rabbit without X11
+
+If you want to run rabbit without X11, install pango, cairo and gtk2 without
+X11 before install rb-rabbit.
+
+  ~% sudo port install pango +no_x11 +quartz
+  ~% sudo port install cairo +no_x11 +quartz
+  ~% sudo port install gtk2 +no_x11 +quartz
+
+=== tips for X11 environment
+
+==== launch X11.app
+
+Rabbit requires X11.app, which is under /Applications/Utilities/.
+
+==== DISPLAY environment variable
+
+Mac OS X 10.4 or earlier, DISPLAY environment was not declared.
+Remember to set this variable.
+
+=== upgrade Rabbit
+
+the following operation upgrades your Rabbit.
+
+  ~% sudo port sync
+  ~% sudo port upgrade rb-rabbit
+
+If you want to upgrade Rabbit only (rb-rabbit), you can upgrade with the "-n"
+option.
+
+  ~% sudo port -n upgrade rb-rabbit
+
+=== Contact
+
+* ((<"../users.rd"/Users group>))
+* Kimura Wataru (kimuraw at i nifty.jp) - maintainer of Rabbit MacPorts

data/doc/en/install/windows.rd

@@ -0,0 +1,103 @@
+---
+layout: en
+title: Install on Windows
+---
+== How to install on Windows
+
+This document describes how to install and use Rabbit on
+Windows.
+
+There are required softwares and optional softwares.
+
+=== Install required softwares
+
+Here are required softwares.
+
+  * Ruby
+  * Rabbit
+
+==== Install Ruby
+
+Install Ruby 1.8.7 from ((<download page of RubyInstall for
+Windows|URL:http://rubyinstaller.org/downloads/>)). For
+example, Ruby 1.8.7-p334 installer can be downloaded via the
+following URL.
+
+: rubyinstaller-1.8.7-p334.exe
+   ((<URL:http://rubyforge.org/frs/download.php/74293/rubyinstaller-1.8.7-p334.exe>))
+
+==== Install Rabbit
+
+RubyInstaller install "Start Command Prompt with Ruby"
+program into start menu. This program shows command prompt
+with PATH configuration for ruby.exe. You can install Rabbit
+by the following command on the command prompt:
+
+  > gem install rabbit
+
+Related softwares (e.g. Ruby/GTK2 and so on) are also
+install automatically.
+
+Now you can run Rabbit by the following command:
+
+  > rabbit https://raw.github.com/shockers/rabbit/master/sample/thema-bench-en.hiki
+
+=== Install optional softwares
+
+Here are optional softwares:
+
+  * RDtool
+  * Ghostscript
+  * Enscript
+  * div
+
+==== Install RDTool
+
+Install ((<RAA:rdtool>)).
+
+Extract the following archive and execute setup.rb to install.
+
+: rdtool-0.6.20.tar.gz
+   ((<URL:http://www.moonwolf.com/ruby/archive/rdtool-0.6.20.tar.gz>))
+
+==== EPS format support
+
+(1) Install AFPL Ghostscript for Win32.
+
+    : gs853w32.exe
+        ((<URL:ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs853/gs853w32.exe>))
+
+(2) Add <Ghostscript Install Path>/gs/gs8.53/bin to the PATH environment variable.
+
+==== Source code highlighting support
+
+(1) Install Enscript.
+
+    : enscript-1.6.3-9-bin.exe
+        ((<URL:http://sourceforge.net/project/showfiles.php?group_id=23617&package_id=16960>))
+
+(2) Add <Enscript Install Path>/bin to the PATH environment variable.
+
+(3) You may need to obtain ruby.st for Ruby syntax highlighting.
+
+      > cd <Enscript Install Path>/share/enscript/hl
+      > ruby -ropen-uri -e "puts open('http://viewvc.rubyforge.mmmultiworks.com/cgi/viewvc.cgi/trunk/support/ruby.st?root=support&view=co').read" > ruby.st
+
+(4) Install ((<RAA:htree>)).
+
+    Extract the following archive and execute install.rb to install.
+
+    : htree.tar.gz
+        ((<URL:http://cvs.m17n.org/viewcvs/ruby/htree.tar.gz>))
+
+==== Use rabrick
+
+Install ((<RAA:div>)).
+
+Extract the following archive and execute install.rb to install.
+
+: div-1.3.2.tar.gz
+   ((<URL:http://www2a.biglobe.ne.jp/~seki/ruby/div-1.3.2.tar.gz>))
+
+
+Sorry for having so many steps.

data/{NEWS.en → doc/en/news.rd}

@@ -1,8 +1,83 @@
-# -*- rd -*-
+---
+layout: en
+title: News
+apply_data: false
+---
+== 0.9.3: 2010-06-25
 
-= NEWS.en
+A comment and Twitter support improved release.
 
-$Id: NEWS.en 1455 2010-12-31 09:13:21Z kou $
+=== Improvements
+
+==== Core
+
+  * Supported PDF viewer on Ruby 1.9.
+    [Reported by tmtms]
+  * [#199] Supported "~" expansion in path specified by "-I".
+    [Reported by kdmsnr]
+  * Supported Twitter's OAuth.
+  * Supported Bundler.
+  * Added Rabbit.add_cleanup_proc that is an API to register
+    a hook on rabbit command finished.
+  * Added rabwii command to control Rabbit via Wii Remote.
+    [Based on Kiwamu Okabe's code]
+  * Changed default dRuby server bind address to localhost.
+  * Changed default --default-public-level to "all".
+  * rabbitter: Used OAuth.
+  * rabrick: Changed --druby-uri option to --rabbit-uri.
+  * rabbit-command: Changed --druby-uri option to --rabbit-uri.
+  * Removed comment view.
+  * rabbitter: Added --user-language option.
+  * Used GUI logger by default when Rabbit isn't invoked by
+    rubyw.exe.
+    [Helped by Nobuyoshi Nakada]
+  * Added launcher mode that show file chose dialog when
+    Rabbit invoked without source file on no console environment.
+  * Supported tag in Hiki notation. ({{tag('tag-name', 'value')}}
+
+==== Theme
+
+  * title-background-image: Supported image file name in
+    slide property.
+    [Suggested by kdmsnr]
+  * background-image-toolkit: Used slide property rather
+    than options in theme.
+  * image: Made image caption's font size customizable.
+  * color-circle: Enabled newline-in-slides and tag theme by
+    default.
+  * slide-number: Made slide number position customizable.
+    [Youhei SASAKI]
+  * debian: Updated.
+    [Youhei SASAKI]
+  * dark-gradation: Added. It's Keynote like dark gradation
+    theme.
+    [Youhei SASAKI]
+  * twitter-comment: Added. It imports tweets from Twitter
+    as comments.
+    [Based on Kiwamu Okabe's code]
+  * comment: Removed. It's for removed comment view.
+  * footer-comment: Added. It shows comments on the footer.
+    [Based on Kiwamu Okabe's code]
+  * clutter-comment: Added. It streams comments on slides
+    with rolling by Clutter API.
+  * stream-comment: Added. It streams comments on slides.
+
+=== Fixes
+
+==== Core
+
+  * Fixed Clutter backend doesn't work.
+    [Reported by OBATA Akio]
+  * Fixed GUI logger doesn't work.
+
+=== Thanks
+
+  * tmtms
+  * kdmsnr
+  * OBATA Akio
+  * Youhei SASAKI
+  * Kiwamu Okabe
+  * Nobuyoshi Nakada
 
 == 0.9.2: 2010-12-31