• View
• Edit
• History
• Print
• Backlinks

SourceBlock

Question answered by this recipe

I tried the (abandoned) Beautifier recipe to perform syntax highlighting for my source code but still wasn't very satisfied... What's next?

Description

Here you'll find SourceBlock: a script recipe dedicated to syntax highlighting, which offers more features:

• Numbered lines on some source code.
• Ordered lists item number preserved when mixed with source code excerpts.
• Extra highlighting to point-out specific source lines.
• Page layout preserved with auto/forced word wrapping of source code lines.
• Language neutral mode without errors when the language is not specified or not recognized.
• Link to view/download individual source code excerpts.

Notes and Comments

SourceBlock is based on GeSHi, a source code highlighting script last updated on 19^th of Aug, 2012, already used in several other wiki systems. In the meantime GeSHi development and downloads have moved to https://github.com/GeSHi/geshi-1.0.

Installation

1. Download and copy sourceblock.phpΔ to the cookbook/ directory.
2. Download and unpack the current GeSHi distribution to a newly created cookbook/geshi directory.
   • The 'cookbook/geshi' directory should contain the geshi.php file and the geshi subdirectory containing the ~250 syntax files.
3. Enable the recipe in your local/config.php file with:
   include_once("$FarmD/cookbook/sourceblock.php");

Markup

Once installed, it adds markup of the form:

and:

with the following optional PARAMETERS:

• lang=LANGUAGE to select one of the supported highlighters,
• linenum{=LINE_NUMBER} to enable line numbers and optionally specify styling alternative,
• linestart=START_NUMBER to specify the initial line number.
• tabwidth=TAB_WIDTH to set the number of spaces to use for tab replacement(*).
• header=TEXT and footer=TEXT to surround the source code(*).
• highlight='LINE_NUMBER1, LINE_NUMBER2,...' to specify the line numbers to point-out (separators are spaces, comma and semicolon).
• -trim to disable the automatic trimming of source.
• -link to disable the automatic generation of documentation links(*).
• -getcode, +getcode to disable or enable the "Get Code" view/download code link (see below).
• id=ID, class=CLASS to overload default styles definitions.

SourceBlock configures GeSHi to use <div> and style sheets then word wrapping is less problematic.

In order to be a full alternative to CodeBlock, SourceBlock provides following extra markup to generate <pre>(formatted) sections (with optional wrapping):

and:

Both markups don't need to start a new line, and may be appended to list elements without altering their order.

The extra "Get Code" link provides a direct access to the unformatted code. The markup also handle the related parameters:

• filename=<name> to provide a relevant name to the block.
• -inline to force browsers to download the block content (ie. sole available behavior in Internet Explorer).

Blocks appearance is controlled via style sheets parts overrideable in config.php. Defaults style are given as recipe samples in the sandbox below.

An additional:

markup form is available to list all the languages supported by the GeSHi installation.

Optional external file handling

The recipe script detects any previous installation of the Linked Resource Extras recipe and if so, provide the two more markup directive to render external files:

and:

The markup parameters have the same meaning. Please refer to Linked Resource Extras recipe page for more details on the FILE_RESOURCE specification itself.

SandBox

(:source lang=css header="$HTMLStylesFmt['sourceblock'] = '" footer="';":) [=
.sourceblocklink {
  text-align: right;
  font-size: smaller;
}
.sourceblocktext {
  padding: 0.5em;
  border: 1px solid #808080;
  color: #000000;
  background-color: #F1F0ED;
}
.sourceblocktext div {
  font-family: monospace;
  font-size: small;
  line-height: 1;
  height: 1%;
}

.sourceblocktext div.head,
.sourceblocktext div.foot {
  font: italic medium serif;
  padding: 0.5em;
}=]

(:source lang=css header="$HTMLStylesFmt['codeblock'] = '" footer="';":)
.codeblocklink {
  text-align: right;
  font-size: smaller;
}
.codeblocktext {
  text-align: left;
  padding: 0.5em;
  border: 1px solid #808080;
  color: #000000;
  background-color: #F1F0ED;
}
.codeblocktext pre {
  font-family: monospace;
  font-size: small;
  line-height: 1;
}
(:sourcend:)

(:source lang=bash:)
#!/bin/sh

# petit script qui genere la cle et le certificat d'un site https
DIR=/etc/apache-ssl/ssl-cert
# nom du certif/du site
NAME=$1
SSL=`which openssl`

# check if dir is OK
if [ ! -d $DIR ]; then
        echo "Dir $DIR not found, building it."
        mkdir -p $DIR
fi
(:sourcend:)

(:source lang=sql linenum tabwidth=4 :)
-- Find all Boards and the schools they Govern
-- Include the status of the school

SELECT sch.orgname AS 'SchoolName', 
	bot.orgName AS 'BoardName', 
	sch.[OrgEventStatusCode] AS Status
FROM organisation AS sch,
	orgGroup AS og ,
	organisation AS bot
WHERE bot.BusinessEntityID = og.OrgBusinessEntityID	-- get the org that is the OWNER
AND og.MemberBusinessEntityID = sch.BusinessEntityID	-- get the org that is the MEMBER
AND og.OrgGroupEndDate is NULL		-- NOT an ended group membership
AND og.orgRoleGroupCode = 'GOVERN'	-- Group for school boards
AND og.OrgRoleCode = 'SCHBRD'		-- Role for school board members
ORDER BY BoardName
(:sourcend:)

# blupp blupp blupp\\
(:source lang=php:)
<? echo "here's some code"; ?>
(:sourcend:)

# blipp blipp

(:source lang=xml:)
<skos:Concept rdfs:label="root" xmlns:skos="http://www.w3.org/2004/02/skos/core"
  xmlns:my="http://www.ontologies.thomson.com/MyVocabulary" 
  xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema" tr:index="1">
</skos:Concept>
(:sourcend:)

Release Notes

2019-07-16

PHP 7.2 fix

2014-09-08

Fixed stupid bug

2014-08-26

Updated recipe for PHP 5.5

2012-07-06

Fixed bug in style handling (multiple blocks on the same page).

2012-07-05

Integrated suggested modifications (trimming reduced to line-breaks, sorted languages list).

2009-01-27

Fixed multiple blocks of code with different languages on the same page bug. Fixed 'linenum=...' option and introduced 'linestart=...'.

2008-09-16

Fixed the '-getcode' option handling for the (:source:) markup.

2008-06-12

Fixed bugs introduced by previous style features and some code cleanup.

2008-06-11

Added the 'id=...' and class=... style related options. Reduced PHP notice messages. Fixed bug in option handling.

2008-01-02

Added (:source langs:) markup to list supported languages.

2007-12-05

Fixed XHTML validation issue.

2007-10-18

Fixed external file handling (was limited to Attachments).

2007-09-13

Fixed trimming bug. Added ';' as highlighting line separator

2007-09-10

Added the '-getcode' option. Renamed the confusing '-attach' to '-inline' option.

2007-05-07

Added forgotten <:vspace> fix.

2007-04-30

Code cleanup. Added a fix to "Get Code" feature. Added support for external files.

2006-10-25

Added RecipeInfo data.

2006-09-07

Code cleanup. Added highlight feature.

2006-03-07

Fixed IE css glitch. Updated licensing terms.

2006-02-28

Heavily revamped to allow view/download of individual source code excerpts.

2005-09-04

Fixed <:vspace> oddities with 2.0.0 and above.

2005-06-15

Fixed bug eating last line when using source without lang attribute.

2005-04-01

Fixed bug preventing different languages on the same page.

2005-03-29

Synced with 2.0.beta27 markup directive syntax.

See Also

Contributors

• Dfaure

Comments

See discussion at SourceBlock-Talk

List of all supported languages

⚠ (:source langs:)