0.16.1

INSTALLATION INSTRUCTIONS

Warning: Create Frequent Backups!

Though many features are already working as expected, Manuskript is still in the early development stages. We recommend creating frequent backups to minimize data loss due to software bugs, power outages, or hardware failure.

This directory contains binary and source packages for Manuskript 0.16.1.

GNU/LINUX

• DEBIAN Based (Debian, Ubuntu, etc.)

  Download manuskript-0.16.1-1.deb, then update repository and install program with:

    sudo apt update
    sudo dpkg -i manuskript-0.16.1-1.deb
  

  If errors encountered then install dependencies and re-install program with:

    sudo apt install -f
    sudo dpkg -i manuskript-0.16.1-1.deb
  

• FEDORA Based (Fedora, CentOS, etc.)

  Download manuskript-0.16.1-1.noarch.rpm, then install program and dependencies with:

    sudo dnf install manuskript-0.16.1-1.noarch.rpm
  

• Flatpak Package (sandboxed desktop application)

  Install Manuskript flatpak package using instructions found in Basic flatpak usage tutorial.

    flatpak install ch.theologeek.Manuskript
  

• Snap Package (Mint, desktops without Qt integration, etc.)

  Install Manuskript snap package using instructions found in Basic snap usage tutorial.

    sudo snap install --edge manuskript
  

• OTHER GNU/Linux

  Download manuskript-0.16.1.zip source code file and follow the steps to Run Manuskript from Source Code on Linux.

WINDOWS

Download manuskript-0.16.1-windows.zip, unzip file, and run manuskript/manuskript.exe.

Warning: Unfortunately some anti-virus software detect a false positive with this windows pyinstaller file, as is sometimes the case with files created with PyInstaller. See also Manuskript Issue #112 - Trojan in current windows installer?. You can either disregard the warning as the file is not dangerous, or you can choose to install from source code as listed under the heading OTHER.

MAC OS X

Download manuskript-0.16.1-osx.dmg and open it.

Warning: Unfortunately macOS expects software to be officially signed but we don't have the resources to do that. So currently the operating system might not let you install/run the software immediately. In OS X security settings, a button appears, allowing you to start Manuskript "anyway" (as in "even if we told you it could be a dangerous malware"). Then, the software should open and run as expected. (For more details see here)

Extra

Import and Export Formats

Install pandoc for more import and export document formats such as ePub, OpenDocument (LibreOffice), and DocX (MS Word).

Spell and grammar check

Install language_tool_python for more detailed spell and grammar checking in your projects. It requires Java to be used and might slow down the loading times significantly. So a performant system is recommended at the moment (optimizations are planned in next releases).

OTHER

Manuskript can be run from source code on:

• GNU/LINUX
• WINDOWS
• MAC OS X

See the Manuskript Wiki for instructions on how to install and run Manuskript from source code.