Skip to content

apaeffgen/PanConvert

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Readme first

Help and further information

At the official Website you will find more detailed information. There is help available at http://panconvert.sourceforge.net/help.html

Installation

On Windows and Mac the automated installer walks you through the installation procedure and copies a bundled pandoc version with pandoc and an uninstaller. So you do not need to install pandoc yourself. You will find the binaries here

On Linux please read the extended installation instruction.

Usage

In the preference settings you can specify the path of your own pandoc, if you do not want to use the bundled version. The help, see above, can be used also inside the started Gui.

Update from previous versions

If Panconvert previously had been used, the previous settings may have to be deleted, or Panconvert may crash:

  • On Windows, open registry editor go to HKEY_CURRENT_USER/Software and delete the folder Pandoc
  • On MacOS delete /Users//Library/Preferences/com.apaeffgen.PanConvert.plist
  • On Linux delete /home//.config/Pandoc/PanConvert.conf

Known Problems

Not working is python2, QT4 and pyqt4. There can be some issues with older or newer versions of QT5 and pyqt5. QT5.11.0 to 15 is tested for the actual source code, and is working.

Also some pandoc versions may make some problems, due to changed behaviour of pandoc or some faults in pandonvert. If you find a bug / problem, submit a bug-report to the issue-tracker of github.

Extended installation instructions for running the source code or running on Linux

Running the program you must have installed the following additional software-packages:

  • pandoc (all newer versions are supported, tested with pandoc 3.1.8 )
  • python3 (Be awere, that the newest python version may break something)
  • QT5
  • pyqt5

On Linux most actual distributions come preinstalled with the last 3 packages. Package-Managers allow to install pandoc.

On Windows you have to manually install all the packages by hand. See all the links below.

On MacOS homebrew can be used to install python3, QT5 and pyqt5. Pandoc has to be downloaded from the pandoc-homepage.

If all the dependencies are properly installed, you can run the program: On the commandline you have to first cd into the appropriate directory.

  • on windows by double-clicking on Panconvert.py
  • on Linux by starting the commandline: python3 Panconvert.py
  • on MaOS by opening the terminal and typing python3 Panconvert.py

License

The software is licensed under the GNU General Public License.