Source

pdfmasher /

Filename Size Date modified Message
cocoa
cocoalib [02fb8a7de8b9]
core
debian
help
hscommon [3c3964b9850a]
images
qt
qtlib [ad0d5769a487]
178 B
125 B
147 B
94 B
1.5 KB
5.5 KB
4.7 KB
1.1 KB
3.8 KB
57 B
94 B
73 B
Contents
========

This package contains the source for PdfMasher. To learn how to build it, refer to the "Build PdfMasher" section. Below is the description of the various subfolders:

- core: Contains the core logic code for PdfMasher. Written in Python.
- cocoa: UI code for the Cocoa toolkit. It's Objective-C code.
- qt: UI code for the Qt toolkit. It's written in Python and uses PyQt.
- images: Images used by the different UI codebases.
- debian_*: Skeleton files required to create a .deb package
- help: Help document, written for Sphinx.

There are also other sub-folder that comes from external repositories (automatically checked out
with as mercurial subrepos):

- hscommon: A collection of helpers used across HS applications.
- cocoalib: A collection of helpers used across Cocoa UI codebases of HS applications.
- qtlib: A collection of helpers used across Qt UI codebases of HS applications.

PdfMasher Dependencies
======================

Before being able to build PdfMasher, a few dependencies have to be installed:

General dependencies
--------------------

- Python 3.2 (http://www.python.org)
- pdfminer3k (http://hg.hardcoded.net/pdfminer3k)
- Sphinx 1.0.7 (http://sphinx.pocoo.org/)
- pytest 2.0.3, to run unit tests. (http://pytest.org/)

Note: Sphinx doesn't officially support Python 3.x yet, but it doesn't matter because it is invoked
by the build system through command line, so you can build PdfMasher even if Sphinx is installed in
your Python 2.x install.

OS X prerequisites
------------------

- XCode 3.1 (http://developer.apple.com/TOOLS/xcode/)
- Sparkle (http://sparkle.andymatuschak.org/)
- PyObjC 2.3 (http://pyobjc.sourceforge.net/)
- pluginbuilder 1.0.1 (http://bitbucket.org/hsoft/pluginbuilder)

Windows prerequisites
---------------------

- Visual Studio 2008 (Express is enough) is needed to build C extensions. (http://www.microsoft.com/Express/)
- PyQt 4.7.5 (http://www.riverbankcomputing.co.uk/news)
- cx_Freeze, if you want to build a exe. You don't need it if you just want to run PdfMasher. (http://cx-freeze.sourceforge.net/)
- Advanced Installer, if you want to build the installer file. (http://www.advancedinstaller.com/)

Linux prerequisites
-------------------

- PyQt 4.7.5 (http://www.riverbankcomputing.co.uk/news)

The easy way!
-------------

There's an easy way to install the majority of the prerequisites above, and it's pip
(http://www.pip-installer.org/) which has recently started to support Python 3. So install it and
then run::

    pip install -r requirements-[osx|win|lnx].txt

([osx|win|lnx] depends, of course, on your platform). Because Sphinx doesn't support Python 3 yet,
it's not in the requirements file and you'll have to install it manually. You might have to compile
PyObjC manually too (see gotchas below). Sparkle and Advanced Installer, having nothing to do with
Python, are also manual installs. PyQt also needs to be installed manually: the package is on PyPI,
but there's no download available.

Prerequisite gotchas
--------------------

Correctly installing the prerequisites is tricky. Make sure you have at least the version number 
required for each prerequisite.

If you didn't use mercurial to download this source, you probably have an incomplete source folder!
External projects (hscommon, qtlib, cocoalib) need to be at the root of the PdfMasher project
folder. You'll have to download those separately. Or use mercurial, it's much easier.

As far as I can tell, you don't *have* to compile/install everything manually and you can normally
use `easy_install` to install python dependencies. However, be aware that compiling/installing
manually from the repositories of each project is what I personally do, so if you hit a snag 
somewhere, you might want to try the manual way.

PyObjC's website is badly outdated. Also, as far as I can tell, the package installable with
`easy_install` has good chances of not working. Your best bet is to download the latest tagged
version from the repository and compile it from source.

Also, on OS X, don't try to use the built-in python 2.x to install Sphinx on (the only pre-requisite
that doesn't run on python 3 yet). There's some weird error popping up when PdfMasher tries to build 
its help file. Install your own framework version of python 2.7, and then install Sphinx on that. 
When Sphinx supports Python 3, things will be easier because you'll be able to install sphinx on the 
same Python version you build PdfMasher with.

Another one on OS X: I wouldn't use macports/fink/whatever. Whenever I tried using those, I always 
ended up with problems.

Also, I don't know yet if it's possible to compile PdfMasher with XCode 4, I haven't tried it yet.
It's safer to use XCode 3.x. However, I don't see why it wouldn't work, so it very well might work.

Whenever you have a problem, always double-check that you're running the correct python version. 
You'll probably have to tweak your $PATH.

Building PdfMasher
==================

First, make sure you meet the dependencies listed in the section above. Then you need to configure
your build with:

	python configure.py
	
If you want, you can specify a UI to use with the `--ui` option. So, if you want to build PdfMasher
with Qt on OS X, then you have to type `python configure.py --ui=qt`. You can also use the `--dev`
flag to indicate a dev build (it will build `pyplugin.plugin` in alias mode and use the "dev" config
in XCode).

Then, just build the thing and then run it with:

	python build.py
	python run.py

If you want to create ready-to-upload package, run:

	python package.py
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.