[ANN] Papyrus 0.0.1 released

ruby-talk
1

Hi there,

I'm pleased to announce the very first release of Papyrus, a RDoc plugin
for generating PDF files from your sourcecode's documentation.

== Installation

It's available via RubyGems. Do

# gem install papyrus

to get it.

== Usage

You can use it the same way as any other RDoc generator plugin, namely

$ rdoc -f papyrus YOURFILESHERE

You can also use it in Rake tasks if you want;

gem "rdoc" #Note you need the gem!
require "rdoc/task"
RDoc::Task.new do |t|
  t.generator = "papyrus"
  #...
end

== Websites

* Project page: http://redmine.pegasus-alpha.eu/projects/papyrus
  (it's a bit spare at the moment, but forgive me, I just completed
  coding ;-))
* Issue tracker: http://redmine.pegasus-alpha.eu/projects/papyrus/issues

== License

It's licensed under the GPLv2, see COPYING in the source for more
information.

== Thanks

Thanks to Eric Hodel's invaluable help--without him, Papyrus wouldn't
have made it to this release.

Have fun!

Valete,
Marvin

2

"sh: pdflatex: command not found
Invoking pdflatex failed with exitstatus 127!"

I'm not sure how to get this. I tried `brew install tex` and it sent me to
http://www.tug.org/mactex/2011/ which is apparently 1.8GB zipped. Too much
commitment for me, I just want to try it out.

Then I tried dling and installing pdftex (
http://www.tug.org/applications/pdftex/\) per the man page's suggestion (
Linux Manpages Online - man.cx manual pages) which I thought worked, but apparently not
since there is no pdflatex in my path still, nor anywhere within the dir I
constructed it in, nor within the original source dirs.

I feel like I might be missing something obvious, what am I doing wrong?

···

On Wed, Aug 17, 2011 at 4:47 PM, Quintus <sutniuq@gmx.net> wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi there,

I'm pleased to announce the very first release of Papyrus, a RDoc plugin
for generating PDF files from your sourcecode's documentation.

== Installation

It's available via RubyGems. Do

# gem install papyrus

to get it.

== Usage

You can use it the same way as any other RDoc generator plugin, namely

$ rdoc -f papyrus YOURFILESHERE

You can also use it in Rake tasks if you want;

gem "rdoc" #Note you need the gem!
require "rdoc/task"
RDoc::Task.new do |t|
t.generator = "papyrus"
#...
end

== Websites

* Project page: http://redmine.pegasus-alpha.eu/projects/papyrus
(it's a bit spare at the moment, but forgive me, I just completed
coding ;-))
* Issue tracker: http://redmine.pegasus-alpha.eu/projects/papyrus/issues

== License

It's licensed under the GPLv2, see COPYING in the source for more
information.

== Thanks

Thanks to Eric Hodel's invaluable help--without him, Papyrus wouldn't
have made it to this release.

Have fun!

Valete,
Marvin
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJOTDaeAAoJELh1XLHFkqhaJ8oH/idZWa6DNWQ9xXF0dmeYKkPd
nih1zRLh9G8Zv2uqT7eYce1tcusaszDjKQyR0hq2GwCZ2/VzDkqvpvK1irnrY1T8
W0Qawu1KFkXtXZFyh1yXWMiWcs0BXvacNp8ZboBvnxjJrtMPt6JqyBbB/meWbLki
xvHdpLawFlyjsG9Kc0l5Qk9DdRfEoJPUslQfpZDnlD1pZ4AIDVagiW1yEPVG/0Y+
9MU7Sd/sd+baxWsUYt5y/PzGP0ruriBbwZwTJsx2jZS3/+UdcFQSq/oYynUTOCT+
yBHkUfq/M/ZHpMRk5rkYeTr464Mlvb1h9QDzc0DXh6gDdHXBFTPzHrz/GaC3VYM=
=99Zp
-----END PGP SIGNATURE-----

3

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi there,

I'm pleased to announce the very first release of Papyrus, a RDoc plugin
for generating PDF files from your sourcecode's documentation.

== Installation

It's available via RubyGems. Do

# gem install papyrus

to get it.

== Usage

You can use it the same way as any other RDoc generator plugin, namely

$ rdoc -f papyrus YOURFILESHERE

You can also use it in Rake tasks if you want;

gem "rdoc" #Note you need the gem!
require "rdoc/task"
RDoc::Task.new do |t|
t.generator = "papyrus"
#...
end

== Websites

* Project page: http://redmine.pegasus-alpha.eu/projects/papyrus
(it's a bit spare at the moment, but forgive me, I just completed
coding ;-))
* Issue tracker: http://redmine.pegasus-alpha.eu/projects/papyrus/issues

== License

It's licensed under the GPLv2, see COPYING in the source for more
information.

== Thanks

Thanks to Eric Hodel's invaluable help--without him, Papyrus wouldn't
have made it to this release.

Have fun!

Valete,
Marvin
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJOTDaeAAoJELh1XLHFkqhaJ8oH/idZWa6DNWQ9xXF0dmeYKkPd
nih1zRLh9G8Zv2uqT7eYce1tcusaszDjKQyR0hq2GwCZ2/VzDkqvpvK1irnrY1T8
W0Qawu1KFkXtXZFyh1yXWMiWcs0BXvacNp8ZboBvnxjJrtMPt6JqyBbB/meWbLki
xvHdpLawFlyjsG9Kc0l5Qk9DdRfEoJPUslQfpZDnlD1pZ4AIDVagiW1yEPVG/0Y+
9MU7Sd/sd+baxWsUYt5y/PzGP0ruriBbwZwTJsx2jZS3/+UdcFQSq/oYynUTOCT+
yBHkUfq/M/ZHpMRk5rkYeTr464Mlvb1h9QDzc0DXh6gDdHXBFTPzHrz/GaC3VYM=
=99Zp
-----END PGP SIGNATURE-----

"sh: pdflatex: command not found
Invoking pdflatex failed with exitstatus 127!"

I'm not sure how to get this. I tried `brew install tex` and it sent me to
http://www.tug.org/mactex/2011/ which is apparently 1.8GB zipped. Too much
commitment for me, I just want to try it out.

Tex is a typesetting system, so it comes with a lot of fonts, styles, etc.
Hence the bit download for the full distribution. Basically its all packages
that were ever accepted into the tex package system.

The Tex community values "write once, compile anywhere, even 10 years in the
future", so they ensure that the main distributions hold everything.

Then I tried dling and installing pdftex (
http://www.tug.org/applications/pdftex/\) per the man page's suggestion (
Linux Manpages Online - man.cx manual pages) which I thought worked, but apparently not
since there is no pdflatex in my path still, nor anywhere within the dir I
constructed it in, nor within the original source dirs.

Thats too basic, as it only includes the typesetting system and nothing else :).
You would not want to download all the packages on your own :).

I feel like I might be missing something obvious, what am I doing wrong?

Yes:

http://www.tug.org/mactex/2011/morepackages.html

Has a "BasicTex" package for 69MB. I don't know whether papyrus uses extra-fancy stuff, but
from a short glance it doesn't. As the page correctly says: "The package is remarkably capable.",
so it should work.

If it doesn't work with BasicTex, I recommend writing a bug report to the author :).

Regards,
Florian

···

On Aug 18, 2011, at 12:45 AM, Josh Cheek wrote:

On Wed, Aug 17, 2011 at 4:47 PM, Quintus <sutniuq@gmx.net> wrote:

--
Florian Gilcher

smtp: flo@andersground.net
jabber: Skade@jabber.ccc.de
gpg: 533148E2

4

Then I tried dling and installing pdftex (
http://www.tug.org/applications/pdftex/\) per the man page's
suggestion ( Linux Manpages Online - man.cx manual pages) which I thought worked,
but apparently not since there is no pdflatex in my path still, nor
anywhere within the dir I constructed it in, nor within the original
source dirs.

I feel like I might be missing something obvious, what am I doing
wrong?

Hi Josh,

I can't help with OS X-specific issues as I don't have one--I'm using
Arch Linux and TeX Live as my LaTeX distribution, just installed via

# pacman -S texlive-full

I'm not sure how to get this. I tried `brew install tex` and it sent
me to http://www.tug.org/mactex/2011/ which is apparently 1.8GB
zipped. Too much commitment for me, I just want to try it out.

Yeah, if one doesn't have LaTeX installed, it looks really heavy, it's
one of the biggest softwares I'm aware of. It is however incredibily
powerful you should really have a look at it aside form Papyrus.

Then I tried dling and installing pdftex (

It seems you're running into the difference between TeX and LaTeX. LaTeX
is a macro package atop of TeX, and usually doing plain TeX is
considered lowlevel when dealing with LaTeX as most people do. Maybe
someone using a Mac can comment on this? I'll put something up in
Papyrus' wiki then.

If you want to have a glance on the output it produces, download

http://redmine.pegasus-alpha.eu/attachments/3/Documentation.pdf

. This is Papyrus' own documentation generated with Papyrus itself.

Vale,
Marvin

···

Am 18.08.2011 00:45, schrieb Josh Cheek:

5

Thats too basic, as it only includes the typesetting system and
nothing else :). You would not want to download all the packages on
your own :).

I feel like I might be missing something obvious, what am I doing
wrong?

Yes:

http://www.tug.org/mactex/2011/morepackages.html

Has a "BasicTex" package for 69MB. I don't know whether papyrus uses
extra-fancy stuff, but from a short glance it doesn't. As the page
correctly says: "The package is remarkably capable.", so it should
work.

If it doesn't work with BasicTex, I recommend writing a bug report to
the author :).

As I already stated, I can't be of much help on OS X, but for the record
here are the LaTeX packages that Papyrus makes use of:

* LaTeX itself.
* babel
* inputenc
* fontenc
* lmodern
* textcomp
* eurosym [Loaded, but not used yet]
* lastpage
* geometry
* fancyhdr
* fancyvrb
* longtable
* xcolor
* titlesec
* titletoc
* hyperref

If any of these is missing, Papyrus will fail with a "Invoking pdflatex
failed with exitstatus XY" exception. To get more detailed output, you
can run rdoc with the --debug switch, but this can be a mess as it gives
you the full output pdflatex produces during all three runs. Furthermore
you can examine the generated .tex files in the tmp/ subdirectory of
doc/ (or whereever you generate the output into) if Papyrus crashes.

Regards, Florian

Valete,
Marvin

···

Am 18.08.2011 09:50, schrieb Florian Gilcher:

6

Thanks. I installed this, now it's failing with status of 1

"uh-oh! RDoc had a problem:
Invoking pdflatex failed with exitstatus 1!"

I assume that means I'm missing packages, but don't really know.

···

On Thu, Aug 18, 2011 at 2:50 AM, Florian Gilcher <flo@andersground.net>wrote:

> I feel like I might be missing something obvious, what am I doing wrong?

Yes:

http://www.tug.org/mactex/2011/morepackages.html

Has a "BasicTex" package for 69MB. I don't know whether papyrus uses
extra-fancy stuff, but
from a short glance it doesn't. As the page correctly says: "The package is
remarkably capable.",
so it should work.

If it doesn't work with BasicTex, I recommend writing a bug report to the
author :).

7

The problem is less that I don't know what packages you use. The problem is
that I am a heavy TeX user and always have the full package installed. So I
cannot tell you for sure whether all those packages are included in BasicTex.

Also, MacTex corresponds to TexLive but with more OS X integrations (a special
editor etc.). OtherSo BasicTex is a texlive distribution for OS X that installs
a minimal profile.

In my experience, MacTex does not differ from texlive. It comes with everything
you expect (tlmgr, etc.) and doesn't change anything on his own.

Regards,
Florian

···

On Aug 18, 2011, at 12:20 PM, Quintus wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 18.08.2011 09:50, schrieb Florian Gilcher:

Thats too basic, as it only includes the typesetting system and
nothing else :). You would not want to download all the packages on
your own :).

I feel like I might be missing something obvious, what am I doing
wrong?

Yes:

http://www.tug.org/mactex/2011/morepackages.html

Has a "BasicTex" package for 69MB. I don't know whether papyrus uses
extra-fancy stuff, but from a short glance it doesn't. As the page
correctly says: "The package is remarkably capable.", so it should
work.

If it doesn't work with BasicTex, I recommend writing a bug report to
the author :).

As I already stated, I can't be of much help on OS X, but for the record
here are the LaTeX packages that Papyrus makes use of:

* LaTeX itself.
* babel
* inputenc
* fontenc
* lmodern
* textcomp
* eurosym [Loaded, but not used yet]
* lastpage
* geometry
* fancyhdr
* fancyvrb
* longtable
* xcolor
* titlesec
* titletoc
* hyperref

8

Pass the --debug option to RDoc and post the output (but please not
inside the email, use pastie or something like that--you'll get pages).

Vale,
Marvin

···

Am 18.08.2011 18:08, schrieb Josh Cheek:

Thanks. I installed this, now it's failing with status of 1

"uh-oh! RDoc had a problem: Invoking pdflatex failed with exitstatus
1!"

I assume that means I'm missing packages, but don't really know.

9

It looks like this is the issue:

"! LaTeX Error: File `lmodern.sty' not found."

Which seems to be a font called Latin Modern. IDK how the LaTeX community
distributes / installs these things, though.

···

On Thu, Aug 18, 2011 at 11:25 AM, Quintus <sutniuq@gmx.net> wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 18.08.2011 18:08, schrieb Josh Cheek:
> Thanks. I installed this, now it's failing with status of 1
>
> "uh-oh! RDoc had a problem: Invoking pdflatex failed with exitstatus
> 1!"
>
> I assume that means I'm missing packages, but don't really know.
>

Pass the --debug option to RDoc and post the output (but please not
inside the email, use pastie or something like that--you'll get pages).

10

http://mirror.hmc.edu/ctan/fonts/lm.zip

http://www.tug.org/fonts/fontinstall.html
TeX Live and MacTeX
    From a system terminal (aka command prompt, shell window) enter
the command kpsewhich --var-value TEXMFLOCAL to see the directory
name. The default on Unix is (the perhaps unusual-looking)
/usr/local/texlive/2010/../texmf-local, which is just another way of
writing /usr/local/texlive/texmf-local. The year may vary, of course.
    After determining your local tree for installation (see previous
section), the next step is to copy the new files into subdirectories
of that tree. Hopefully, your new font came as a zip or other archive
file that is already arranged according to the standard TeX Directory
Structure (TDS). If this is the case, you can simply unpack it at the
top level of your chosen tree.
    Run the command mktexlsr (the command texhash is a synonym). On
Unix-like systems, run sudo -H mktexlsr if you installed your system
as root (not recommended).
    Run the command:
updmap-sys --enable Map newfont.map

···

On Thu, Aug 18, 2011 at 12:49 PM, Josh Cheek <josh.cheek@gmail.com> wrote:

On Thu, Aug 18, 2011 at 11:25 AM, Quintus <sutniuq@gmx.net> wrote:

Pass the --debug option to RDoc and post the output (but please not
inside the email, use pastie or something like that--you'll get pages).

gist:1154483 · GitHub

It looks like this is the issue:

"! LaTeX Error: File `lmodern.sty' not found."

Which seems to be a font called Latin Modern. IDK how the LaTeX community
distributes / installs these things, though.

11

If I can make some suggestions:

a) Throw out the font and use a basic font. Package installation, especially
font installation for TeX comes straight from the 1970s and is appropriately
ugly.
b) Use XeTeX instead of PDFLaTeX. In my experience, it provides better output anyways,
despite some oddball packages being incompatible with it[1]. It also has built-in UTF-8
support. XeTeX has access to system fonts and an easy macro set to specify them. So you
can pick a nice font that is present on all platforms and just use it.

Regards,
Florian

[1]: Mostly because they check the ability of PDF output by checking whether they run
on PDFLatex. Kind of similar to gems not running on jruby because they check on a MRI
version string.

···

On Aug 18, 2011, at 7:00 PM, brabuhr@gmail.com wrote:

On Thu, Aug 18, 2011 at 12:49 PM, Josh Cheek <josh.cheek@gmail.com> wrote:

On Thu, Aug 18, 2011 at 11:25 AM, Quintus <sutniuq@gmx.net> wrote:

Pass the --debug option to RDoc and post the output (but please not
inside the email, use pastie or something like that--you'll get pages).

gist:1154483 · GitHub

It looks like this is the issue:

"! LaTeX Error: File `lmodern.sty' not found."

Which seems to be a font called Latin Modern. IDK how the LaTeX community
distributes / installs these things, though.

http://mirror.hmc.edu/ctan/fonts/lm.zip

Installing TeX fonts - TeX Users Group
TeX Live and MacTeX
   From a system terminal (aka command prompt, shell window) enter
the command kpsewhich --var-value TEXMFLOCAL to see the directory
name. The default on Unix is (the perhaps unusual-looking)
/usr/local/texlive/2010/../texmf-local, which is just another way of
writing /usr/local/texlive/texmf-local. The year may vary, of course.
   After determining your local tree for installation (see previous
section), the next step is to copy the new files into subdirectories
of that tree. Hopefully, your new font came as a zip or other archive
file that is already arranged according to the standard TeX Directory
Structure (TDS). If this is the case, you can simply unpack it at the
top level of your chosen tree.
   Run the command mktexlsr (the command texhash is a synonym). On
Unix-like systems, run sudo -H mktexlsr if you installed your system
as root (not recommended).
   Run the command:
updmap-sys --enable Map newfont.map

--
Florian Gilcher

smtp: flo@andersground.net
jabber: Skade@jabber.ccc.de
gpg: 533148E2