Texture is a collection of components for realizing content production systems. It has first-class support for JATS, the de facto standard for archiving and interchange of scientific open-access contents with XML.

Clone the repository.

$ git clone https://github.com/substance/texture.git

Navigate to the source directory.

$ cd texture

At the moment, the default branch provides the develop version. To get the latest stable version switch to the master branch:

$ git checkout master

Install via npm

$ npm install

Start the dev server

$ npm run start

And navigate to http://localhost:5001

To run the tests in the browser navigate to http://localhost:5001/test

To run the test suite headless:

$ npm test

Here's how you can integrate Texture into your web app.

// app.js
var Texture = require('substance-texture');
var myTexturePackage = require('./myTexturePackage');
var configurator = new Texture.Configurator(myTexturePackage);

window.onload = function() {
  window.app = Texture.mount({
    mode: 'publisher', // or 'author' or 'reader'
    documentId: 'doc-1',
    configurator: configurator
  }, document.body);
};

Texture is fully configurable. So you need to supply a custom configuration via a package defintion.

// myTexturePackage.js
var MyXMLStore = require('../MyXMLStore');
var texturePackage = require('substance-texture/packages/texture/package');
var path = require('path');

module.exports = {
  name: 'my-texture',
  configure: function(config) {
    // Use the default Texture package
    config.import(texturePackage);

    // Define XML Store
    config.setXMLStore(MyXMLStore);
    // Add your custom app styles
    config.addStyle(__dirname, 'my-texture.scss');
  }
};

In order to connect Texture to a backend you need to define an XML Store:

// MyXMLStore.js
var oo = require('substance/util/oo');
var request = require('substance/util/request');

function MyXMLStore() {}

MyXMLStore.Prototype = function() {
  this.readXML = function(documentId, cb) {
    request('GET', 'https://myserver.com/documents/'+documentId+'.xml', null, cb);
  };

  this.writeXML = function(documentId, xml, cb) {
    var data = {content: xml};
    var url = 'https://myserver.com/documents/'+documentId+'.xml'
    request('PUT', url, data, cb);
  };
};

oo.initClass(MyXMLStore);

module.exports = MyXMLStore;

$ npm run bundle

See CONTRIBUTING.md.

ETA: September 2016

• Update to Substance Beta 5
• Front matter editing for title + abstract (JATS <front>)
• Editing of authors (create, update and delete contrib elements)
• Create and edit xref elements

ETA: October 2016

Goal is to provide proof of concepts for the discussed tagging workflow (get from unstructured text to structured JATS). For example:

• Quality measures for Meta data (#72)
• Identify authors in the text and turn them into nodes (#75)
• Turn a sequence of paragraphs into a reference list (#74)
• Identify title as text and tag as article title (#76)
• Update to Substance Beta 6

Elaborate results of Alpha 3 based on an agreed minimal set of functionalities. For example:

• Document structure fixes (tag headings and set heading level)
• Author tagging
• Figure tagging (caption editing etc.)
• Figure placement
• Bibliography tagging

With these results organisations can start to test Texture-based QC-workflow with real articles.

ETA: Winter 2016

Feature-complete release ready to be tested by publishers.

Texture is developed by the Substance Consortium formed by the Public Knowledge Project (PKP), the Collaborative Knowledge Foundation (CoKo) and Érudit.

Thanks goes to the following people, who make Texture possible:

• Alex Garnett (leadership, concept)
• Juan Pablo Alperin (leadership, concept)
• Alex Smecher (concept, dev)
• Kristen Ratan (leadership)
• Adam Hyde (leadership)
• Jure Triglav (concept, dev)
• Tanja Niemann (leadership)
• Davin Baragiotta (concept, dev)
• David Cormier (dev)
• Sophy Ouch (design)
• Michael Aufreiter (dev)
• Oliver Buchtala (dev)
• ...