Git Product home page Git Product logo

scribus-api's Introduction

Scribus API

A stable, high level and documented interface to the Scribus core that plugin developers can use to access the Scribus features.

Install

Clone the scribus-api repository and put โ€“ or symlink โ€“ its src directory into scribus/plugins/ as api. Then add to CMakeLists.txt file in scribus/.

add_subdirectory(api)

just after add_subdirectory(third_party)

and add

${CMAKE_CURRENT_BINARY_DIR}/api

set(SCRIBUS_API_LIB "scribus_api_lib")

${SCRIBUS_API_LIB}

after each similar line containing the zip string.

In the Getting started manual for Scribus developers, you'll find more in details instructions.

Roadmap

  • setup the plugin
  • activate a first class and method and try to call it from another plugin
  • add lot of doxygen comments
    • each file
    • each class
    • each public method
  • move the epub's plugin ScribusDocument class to the ScribusAPI
  • make more publicity for this project and find out how to improve its architecture / add more coverage of Scribus features.

Doxygen documentation

An older a Doxygen documentation of the code is published here:

http://impagina.org/dox/api/

The documentation can be created by running (at the root of this repository):

doxygen documentation/config.doxygen

This creates the html documentation in the documentation directory.

You can enable, generate and use the latex files to then create a Pdf version of the documentation with pdflatex.

scribus-api's People

Contributors

aoloe avatar

Stargazers

Pathum Egodawatta avatar

Watchers

James Cloos avatar

scribus-api's Issues

cannot call the static function Document::getActive()

In the applyStyle plugin i have

document = ::API::Document::getActive();

It compiles, it links, but fails at runtime with the message:

symbol lookup error: /home/ale/bin/scribus-newspaper/lib/scribus/plugins//libapplystyleplugin.so: undefined symbol: _ZN3API8Document9getActiveEv

The non static version that does almost the same thing (in applyStyle it's (commented out) on the following line does work correctly:

document = std::make_shared<::API::Document>(doc);

The way the API has been added to the CMakeLists.txt files mimics the zip library.
I've tried to add a static function to ScZipHandler and use it in the resources manager (where the zip library is already in use) and it worked correctly.

You can get the Scribus code with the patched CMakeLists.txt (and a setup-newspaper.sh file that pulls in the dependencies) in the scribus-newspaper repository.
(The offending line might be commented out and the non static activated so that the code is usable: in that case you will have to switch the comments...)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.