Metadata-Version: 1.0
Name: omnigraffle-export
Version: 1.4.0
Summary: A command line utility that exports omnigraffle canvases files into various formats with a rubber support.
Home-page: https://github.com/fikovnik/omnigraffle-export
Author: Filip Krikava
Author-email: krikava@gmail.com
License: http://www.opensource.org/licenses/mit-license.php
Description: # OmniGraffle Export tool
        
        A command line tool that allows to export one or more canvases from [OmniGraffle](http://www.omnigroup.com/products/omnigraffle/) into various formats using [OmniGraffle AppleScript interface](http://www.omnigroup.com/mailman/archive/omnigraffle-users/2008/004785.html).
        
        ## Installation
        
        In order to have it successfully installed and working, following is required:
        
        * OmniGraffle 5
        * python >= 2.6
        * [appscript](http://appscript.sourceforge.net/py-appscript/index.html) >= 0.22
        
        You can either clone the repository and use the setup tool:
        
            setup.py install
            
        Or using the PIP:
        
            pip install omnigraffle_export
        
        ## Usage
        
        	Usage: omnigraffle-export [options] <source> <target>
        	
        	Options:
        	  -h, --help  show this help message and exit
        	  -c NAME     canvas name. If not given it will be guessed from the target
        	              filename unless it is a directory.
        	  -f FMT      format (one of: pdf, png, svg, eps). Guessed from the target
        	              filename suffix unless it is a directory. Defaults to pdf
        	  --force     force the export
        	  -v          verbose
        
        If the target file exists it tries to determine whether the canvas has been changed. It does that by comparing the checkums. Since the PDF export always results into a different file, it uses the PDF subject attribute to store there a checksum that will be generated by exporting to a PNG format.
        
        ## Examples
        
        * Export _all_ canvases into directory _figures_ using EPS
        
          `omnigraffle-export -f eps schemas.graffle figures`
        
        * Export canvas named _FullModel_ into a _FullModel.svg_ SVG file:
        
          `omnigraffle-export schemas.graffle FullModel.svg`
        	
        * Export canvas name _FullModel_ into a _my_new_model.pdf_ PDF file:
            
          `omnigraffle-export -c FullModel -f pdf schemas.graffle my_new_model`
        
          or
        
          `omnigraffle-export -c FullModel schemas.graffle my_new_model.pdf`
            
          _Note: that the '.pdf' suffix will be automatically added in the first case._ 
            
        * Export _all_ canvases into directory _figures_ using EPS
        
          `omnigraffle-export -f eps schemas.graffle figures`
        
        ## LaTeX Support Example
        
        One of the main motivation for this package was to be able to quickly export OmniGraffle canvases and use them in LaTeX.
        One of the possible setup is following:
        
        * Every time a figure is included add some instruction so it can be later exported from OmniGraffle file. For example a comment like `% omnigraffle <path/to/.graffle/file> <output>` that would tell the exported to export a canvas `CondorKernel` from `sources/schemas.graffle` into `figures/CondorKernel.pdf` as PDF:
        
            \begin{figure}
              \center
              % omnigraflle: sources/schemas.graffle figures/CondorKernel.pdf
              \includegraphics[scale=.5]{images/CondorKernel}
            \end{figure}
        
        * An example preprocesor in python using [frabric](http://docs.fabfile.org/en/1.4.0/index.html):
        
            from fabric.api import *
            import re
        
            # latex files to process
            fnames = ['UCGridRLDecisionModel.tex']
            omnigraffle_re = re.compile(r'%\s*omnigraflle:\s*([^ ]+)\s+([^ ]+)')
        
            def _convert(source, target):
                local('omnigraffle-export %s %s' % (source, target))
        
            @task
            def schemas():
                '''
                Generate all schemas
                '''
                
                for fname in fnames:
                    with open(fname) as f:
                        for l in f:
                            m = omnigraffle_re.match(l.strip())
                            if m:
                                _convert(*m.groups())
        
Keywords: omnigraffle export
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: Utilities
