% SiSU insert 0.58

@title: SiSU

@subtitle: Syntax Highlighting

@creator: Amissah, Ralph

@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3

@type: information

@subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search

@date.created: 2002-11-12

@date.issued: 2002-11-12

@date.available: 2002-11-12

@date.modified: 2007-09-16

@date: 2007-09-16

@level: new=C; break=1; num_top=1

@skin: skin_sisu_manual

@bold: /Gnu|Debian|Ruby|SiSU/

@links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
{ Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
{ SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
{ SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/
{ SiSU @ Ruby Application Archive }http://raa.ruby-lang.org/project/sisu/
{ SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
{ SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
{ SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
{ SiSU help }http://www.jus.uio.no/sisu/sisu_manual/sisu_help/
{ SiSU help sources }http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/

:A~? @title @creator

:B~? SiSU Syntax Highlighting

1~ Editor Files, Syntax Highlighting

The directory:

_1 ./data/sisu/v1/conf/editor-syntax-etc/

_1 /usr/share/sisu/v1/conf/editor-syntax-etc

contains rudimentary sisu syntax highlighting files for:

_* (g)vim http://www.vim.org

_1 package: sisu-vim

status: largely done

_1 there is a vim syntax highlighting and folds component

_* gedit http://www.gnome.org/projects/gedit

_* gobby http://gobby.0x539.de/

_1 file: sisu.lang

place in:

_1 /usr/share/gtksourceview-1.0/language-specs

or

_1 ~/.gnome2/gtksourceview-1.0/language-specs

_1 status: very basic syntax highlighting

_1 comments: this editor features display line wrap and is used by Goby!

_* nano http://www.nano-editor.org

_1  file: nanorc

save as:

_1 ~/.nanorc

_1 status: basic syntax highlighting

_1 comments: assumes dark background; no display line-wrap; does line breaks

_* diakonos (an editor written in ruby) http://purepistos.net/diakonos

file: diakonos.conf

save as:

_1 ~/.diakonos/diakonos.conf

includes:

_1 status: basic syntax highlighting

comments: assumes dark background; no display line-wrap

_* kate & kwrite http://kate.kde.org

_1 file: sisu.xml

_1 place in:

_2 /usr/share/apps/katepart/syntax

_1 or

_2 ~/.kde/share/apps/katepart/syntax

_1 [settings::configure kate::{highlighting,filetypes}]

_1 [tools::highlighting::{markup,scripts}::SiSU]

% kde-config --prefix
% KDEDIR/share/apps/katepart/syntax/
% KDEHOME/share/apps/katepart/syntax
% [In the configure dialog in kate, go to the "Editor->highlighting" page and
% >select a highlight to change the mimetype/pattern associations for it.]
% /etc/mime.types
% /usr/share/mime/text

_* nedit http://www.nedit.org

_1 file: sisu_nedit.pats

_1 nedit -import sisu_nedit.pats

_1 status: a very clumsy first attempt [not really done]

_1 comments: this editor features display line wrap

_* emacs http://www.gnu.org/software/emacs/emacs.html

_1 files: sisu-mode.el

_1 to file ~/.emacs add the following 2 lines:

_2 (add-to-list 'load-path "/usr/share/sisu/v1/conf/editor-syntax-etc/emacs")

_2 (require 'sisu-mode.el)

_1 [not done / not yet included]

_* vim & gvim http://www.vim.org

_1 files: 

_1 package is the most comprehensive sisu syntax highlighting and editor environment provided to date (is for vim/ gvim, and is separate from the contents of this directory)

_1 status: this includes: syntax highlighting; vim folds; some error checking

_1 comments: this editor features display line wrap

NOTE:

[SiSU parses files with long lines or line breaks, but, display linewrap (without line-breaks) is a convenient editor feature to have for sisu markup]

% aeditor (an editor written in ruby)