Home

Installing

Install Binary (Easier)

• Manuskript Download
• Alternate Manuskript Download
• TIP: Install pandoc for more export document formats such as ePub, OpenDocument (LibreOffice), and DocX (MS Word).

Install Source Code (More Work, Runs on More OS Platforms)

• Run Manuskript from Source Code on Linux
• Run Manuskript from Source Code on Windows
• Run Manuskript from Source Code on Mac OS X

Using

How To...

• How to start a new project
• How to Use Manuskript to Write a Fiction Novel
• How to keep track of important items
• How to Add a Spellcheck Language Dictionary
• How to Add Images to a Project
• How to Enable Dark Theme
• How to run manuskript globally, from anywhere (Linux)

Overview

• Overview of Manuskript Panes
• Overview of Manuskript Right Sidebar
• Overview of Manuskript Menu
• Overview of Manuskript Settings
• See answered questions in the issues tracker

Features

• Keyboard Shortcuts
• Fullscreen mode
• Documentation Snippets
• Import and Export capabilities
• Configuration Settings Storage Locations

Known Issues

Following are some known issues with the upcoming 0.10.0 release.

Qt 5.5.1 (Ubuntu 16.04 with end-of-life April 2021)

• Compile/export will silently overwrite existing file (PR #613)

Qt 5.11.x to 5.12.x

• Import will cause Manuskript to crash (PR #612)

The procedure entry point OPENSSL_sk_new_reserve could not be located...

• This is caused by an incompatibility between PyQt and Python. (Source.)
  • Starting at PyQt 5.12.4, it is built against OpenSSL 1.1.1; prior to that, it was built against OpenSSL 1.1.0.
  • Python 3.7.4+ is built against OpenSSL 1.1.1, but earlier Python versions were built against OpenSSL 1.1.0.
• To fix this, make sure your version of Python and PyQt rely on the same version of OpenSSL.

PyEnchant Spell Check

• A pre-built PyEnchant package is not available on Windows for 64 bit Python (PyEnchant issue #42)
• A work-around is to install PySpellChecker or SymSpellPy on Windows, or to use 32 bit Python.

Mission Statement

The goal of Manuskript is to ease the task of writing large projects by providing facilities to stay organized and track details, while also keeping distractions to a minimum. Functionality is to be provided by Free Software only.

To maximize flexibility an open and plain text file format is used enabling collaboration with third-party tools.

Contributing

Developing

• Manuskript is written in Python3 and PyQt5
• All code changes and Pull Requests should be based on the develop branch.
• The minimum target screen resolution is 1024x600 (was popular with small laptops / netbooks)
• We strive to conform to Qt guidelines. E.g.: User Interface Text Guidelines
• Tip: Add --console as last option on command line to use IPython Jupyter QT Console as a debugging aid.
• DRAFT
  We try to ensure that Manuskript will run on currently supported Operating Systems with Qt integration. This includes several GNU/Linux distributions, in addition to commercially supported versions of Microsoft Windows and Apple macOS X.
  OSes we often use in our testing include: Debian, Fedora, Ubuntu, and Windows.
  No promise of support is provided. See also GNU General Public License.
• Roadmap contains some potential future plans.

Translating

• Translate Manuskript in a new language, or update existing translation

Packaging (for release package file)

• Package Manuskript for Linux with dpkg --> .deb
• Package Manuskript for Linux with rpm --> .rpm
• Package Manuskript for Linux with PyInstaller (Notes for linux packagers: removable files)
• Package Manuskript for Windows with PyInstaller
• Package Manuskript for OS X with PyInstaller
• Bundle manuskript for OS X with Platypus
• Package Manuskript for Linux with Stdeb - NOTE: Does Not Work
• [Packaging]-Generate-Windows-binaries-with-pyInstaller-(HowTo) - NOTE: Older HowTo
• Creating manuskript binary for Android and IOS - Help Wanted

Releasing Official Version

• Steps To Create An Official Manuskript Release