Source Code/scribus

See also : parent folder's documentation

Introduction

This group of pages aims to document some of the important files within the Scribus source code. Scribus has a lot of files and lots of classes within to bring the functionality to the user. There's some basic organisation into directories to distinguish files/classes and their purpose, however the file trees are generally quite large.

Visual Tree

Scribus Source Tree

This page will act similiarly to wiki Source Tree page.

Tree

It will list and summarize all the directories that live within the Scribus project source tree.

├── OSX-package
│   ├── inputs
│   └── linktools
├── Scribus.app
│   └── Contents
├── cmake
│   └── modules
├── devel-doc
│   ├── images
│   └── templates
├── doc
│   ├── cs
│   ├── de
│   ├── en
│   ├── fr
│   ├── it
│   └── pl
├── dtd
├── resources
│   ├── dicts
│   ├── editorconfig
│   ├── icons
│   ├── keysets
│   ├── loremipsum
│   ├── profiles
│   ├── spell_dicts
│   ├── swatches
│   ├── templates
│   ├── translations
│   └── versions
├── scribus
│   ├── colormgmt
│   ├── desaxe
│   ├── designer
│   ├── downloadmanager
│   ├── dtd
│   ├── fonts
│   ├── manpages
│   ├── old
│   ├── plugins
│   ├── styles
│   ├── tests
│   ├── text
│   ├── third_party
│   ├── tt
│   ├── ui
│   └── unicodemap
├── win32
│   └── vc9
└── xcode
    └── Scribus

Related Pages

Low Hanging Fruit

References

Root Directory (Scribus)

The directory contains the main build files for building with CMake (primarily on Unix-like platforms):

• CMakeLists.txt
• ConfigureChecks.cmake
• cmake_uninstall.cmake.in
• config.h.cmake

Various documentation files are included as well such as:

• README
• README.MacOSX
• AUTHORS
• BUILDING
• ...

Sub-Folders

After that, there are a number of directories per the below:

• cmake - This directory contains the additional files to find additional resources on the system for building the code

• devel-doc - This directory contains the files required to build the doxygen based source file documentation. Some classes are better documented than others. :) You can build this documentation by running make in that directory. It takes a while to run through all the source code though. Then you can open the index.html file in your favourite web browser.

• resources - This directory contains a lot of important files for Scribus to run, and are installed with the main Scribus program. Examples are icons, fonts, GUI translation files, document templates, etc.

• Most importantly, there is the scribus directory. This directory is the root of the real source code tree and contains the most important files for the source of Scribus.

The scribus directory contains the source code for Scribus, and plenty of subdirectories with important functionality held within. To name but a few of the important source files...

• main.h/.cpp
  • Where the program starts running from. Its just a stub file that points to the main *nix or win32 main files
• main_nix.h/.cpp
  • Creates the ScribusQApp class (where Qt starts to kick in)
  • Initiates the crash handler
  • Starts and initialises the ScribusQApp instance, and passes the command line to it for parsing
• main_win32.h/.cpp
  • Creates the ScribusQApp class (where Qt starts to kick in) from the scribusapp.cpp file.
  • Initiates the crash handler
  • Starts and initialises the ScribusQApp instance, and passes the command line to it for parsing
• scribusqapp.h/.cpp
  • Initialise the ScribusCore instance which is in scribuscore.cpp
  • Sets up the download manager
  • Parses the command line
  • Sets up the regional settings/languages and loads the GUI translations
• scribuscore.h/.cpp
  • Starts the GUI (ScribusMainWindow class) which is in scribus.cpp
  • Sets up splash screen
  • Finds the fonts on the system
  • Initialises the default program values, key shortcuts
  • Loads the preferences
  • Initialises the colour management system
• scribus.h/.cpp
  • A real monster of a file, which contains a lot of important GUI code for the main window, menus etc.
• scribusview.h/.cpp
  • The view of the Scribus document is contained here and interfaces with the "canvas"
• scribusdoc.h/.cpp
  • Contains most of the code around manipulation of a Scribus document, with many links into page items, etc
• scribuswin.h/.cpp
  • The document window of the Scribus document is contained here and interfaces with the ScribusMainWindows and ScribusView instances.
• pageitem.h/.cpp
  • The base code for all page items is contained here.
• pageitem_*.h/.cpp
  • All of the different page item types have their own classes/files with the specific definitions and needs for the type of item they are.