Help:Books: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 133: Line 133:
; Testing
; Testing
* mw-render --config=http://edutechwiki.unige.ch/mediawiki/ --writer=odf --output=./edutech.odt Educational_technology
* mw-render --config=http://edutechwiki.unige.ch/mediawiki/ --writer=odf --output=./edutech.odt Educational_technology
** OK - [[User:Daniel K. Schneider|Daniel K. Schneider]] 14:06, 4 May 2009 (UTC) (using version mwlib-41c207e76b28/)
** OK - [[User:Daniel K. Schneider|Daniel K. Schneider]] 14:58, 4 May 2009 (UTC) (using version mwlib-41c207e76b28/)


mw-render --config=http://edutechwiki.unige.ch/mediawiki/ --writer=rl --output=./flash-cs3.pdf Flash_CS3_desktop_tutorial
mw-render --config=http://edutechwiki.unige.ch/mediawiki/ --writer=rl --output=./flash-cs3.pdf Flash_CS3_desktop_tutorial
** OK - [[User:Daniel K. Schneider|Daniel K. Schneider]] 14:06, 4 May 2009 (UTC) (using version mwlib-41c207e76b28/)
** OK - [[User:Daniel K. Schneider|Daniel K. Schneider]] 14:58, 4 May 2009 (UTC) (using version mwlib-41c207e76b28/)


* mw-zip --config=http://edutechwiki.unige.ch/mediawiki/ --output=./edutech.zip Educational_technology
* mw-zip --config=http://edutechwiki.unige.ch/mediawiki/ --output=./edutech.zip Educational_technology
Line 153: Line 153:
* http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Collection/README.txt
* http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Collection/README.txt


Add in Localsettings.php (if not already done) the rendering engines you will support. Typing ''mw-render --list-writers'' will list the ones you installed.
Add in Localsettings.php (if not already done) the rendering engines you will support. Typing ''mw-render --list-writers'' will list the ones you installed. E.g.


  $wgCollectionFormats = array(
  $wgCollectionFormats = array(
Line 160: Line 160:
       );
       );


Add in Localsettings.php if not already done:
Add in Localsettings.php if not already done the name and port of the server (altenatively you also could install a cgi script).
  $wgCollectionMWServeURL = "http://xxx.yyy:8899";
  $wgCollectionMWServeURL = "http://xxx.yyy:8899";


Extra stuff
Extra stuff:
  $wgLicenseURL = "http://edutechwiki.unige.ch/fr/EduTech_Wiki:Copyrights";
  $wgLicenseURL = "http://edutechwiki.unige.ch/fr/EduTech_Wiki:Copyrights";
  $wgCollectionMaxArticles = 100;
  $wgCollectionMaxArticles = 100;
Problem: One ought to able to slow down the server. mw-render seems to have a prevision for reducing threads. But no parameter can be set in the mw extension itself.

Revision as of 16:58, 4 May 2009

This extension is experimental for the moment - Daniel K. Schneider 19:02, 30 April 2009 (UTC).

There are problems with server overload. If your book is large you likely will loose between a third and half of the pages. Therefore, only create smaller books.

Genral user information

Basic help:

Further help:

General information:

For wiki maintainers

Bugs and feature requests:

Information about the collection extension and related server-side software

Installation notes

(I will move this at some point - Daniel K. Schneider)

  • The collection extension installs like any other Mediawiki extensions. Really easy with Mediawiki=> 1.14 (Spring 2009).
  • You then can just leave all the defaults and the PDF will be generated by PediaPress.

mwlib installation

(not needed if you have a fast server and want to use the pediapress server)

Made for Solaris

Prerequisites

Install these if don't have them (usually you do)

  • Python => 2.5
  • Perl => 5
  • g++
  • Latex

Install Blahtexml

  • (not done so far)

Install setuptools-0.6c9-py2.5.egg

sh setuptools-0.6c9-py2.5.egg

Install python imaging library (PIL)

 python setup.py install

Install odfpy 0.7.0 (not 0.8.0)

python setup.py build
python setup.py install

Install rec2c

pkgadd -d re2c-0.13.5-sol10-sparc-local 

Install ocaml

pkgadd -d ocaml-3.10.2-sol10-sparc-local
Mwlib (installed with the tar ball, alternatively install mercurial)
 python setup.py install

Alternative:

easy_install mwlib && rehash
pygments
easy_install Pygments
Fribidi - both a library and the Python bindings
./configure --prefix=/usr/local
make
make install

(this is difficult to install)

 setenv fribidi_CFLAGS "-L/usr/local/lib -I/usr/local/include"
 setenv fribidi_LIBS -lfribidi
./configure
make
make install
Ploticus

(not installed)

mwlib.rl
easy_install mwlib.rl

Alternatively from a tarball:

texvc
  • Is in your mediawiki installation
  • Compile with gmake it if not already done (needs ocaml, see above)
cd /XXX/mediawiki/math
gmake
./texvc_test
  • Add the directory to the system path
Configuration

(to do)

Testing

mw-render --config=http://edutechwiki.unige.ch/mediawiki/ --writer=rl --output=./flash-cs3.pdf Flash_CS3_desktop_tutorial

mw-serv

MW Serv provides a server interface for the mw-render engine and mw-zip.

Run the server
mw-serve --cache-dir=/data/mwcache/mwlibcache/ &
Tweaking the collection extension

Add in Localsettings.php (if not already done) the rendering engines you will support. Typing mw-render --list-writers will list the ones you installed. E.g.

$wgCollectionFormats = array(
          'rl' => 'PDF',
          'odf' => 'ODT',
      );

Add in Localsettings.php if not already done the name and port of the server (altenatively you also could install a cgi script).

$wgCollectionMWServeURL = "http://xxx.yyy:8899";

Extra stuff:

$wgLicenseURL = "http://edutechwiki.unige.ch/fr/EduTech_Wiki:Copyrights";
$wgCollectionMaxArticles = 100;

Problem: One ought to able to slow down the server. mw-render seems to have a prevision for reducing threads. But no parameter can be set in the mw extension itself.