Source Code: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
m (testing transclusion here)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Development]][[Category:SourceCode]]
==Introduction==
==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.
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==
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px;">
<big>'''Scribus Source Tree'''</big>
<div class="mw-collapsible-content">{{:Scribus_Source_Tree#Tree}}</div>
</div>


==Root Directory (Scribus)==
==Root Directory (Scribus)==
Line 19: Line 26:
*...
*...
</tt>
</tt>
== Sub-Folders ==


After that, there are a number of directories per the below:
After that, there are a number of directories per the below:
*<tt>cmake</tt> - This directory contains the additional files to find additional resources on the system for building the code
*<tt>cmake</tt> - This directory contains the additional files to find additional resources on the system for building the code
*<tt>devel-doc</tt> - This directory contains the files required to build the [http://www.doxygen.org doxygen] based source file documentation. Some classes are better documented than others. <tt>:)</tt> You can build this documentation by running <tt>make</tt> in that directory. It takes a while to run through all the source code though. Then you can open the <tt>index.html</tt> file in your favourite web browser.
*<tt>devel-doc</tt> - This directory contains the files required to build the [http://www.doxygen.org doxygen] based source file documentation. Some classes are better documented than others. <tt>:)</tt> You can build this documentation by running <tt>make</tt> in that directory. It takes a while to run through all the source code though. Then you can open the <tt>index.html</tt> file in your favourite web browser.
*<tt>resources</tt> - 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.
*<tt>resources</tt> - 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 <tt>[[wiki.scribus.net/canvas/Source_Code/scribus|scribus]]</tt> directory. This directory is the root of the real source code tree and contains the most important files for the source of Scribus.
* '''Most importantly''', there is the <tt>[[Source_Code/scribus|scribus]]</tt> directory. This directory is the root of the real source code tree and contains the most important files for the source of Scribus.

Latest revision as of 23:13, 19 January 2014

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.[1]

├── 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

  1. Retrieved from SVN on 2013-11-21

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.