Here is a quick reference to some common formatting you might want to do on a wiki page.

Adding "@SIG@" to a note will append your signature - see following - along with the date and time but this signature will not display when you preview the page.

-- -- DevonMcCormick 2012-06-13 14:55:39

Otherwise, here are some pitfalls I've encountered working on wiki pages and tips for dealing with them as well as other tips.

## General Tips

What I usually do is examine the source of a page that looks like what I want to accomplish. However, there are a few pitfalls I can warn you about.

### ''Preview'' is Your Best Friend

Use the Preview button early and often. This will keep your lock on the page current and alert you early on when you make a mistake. [Just now, upon entering the minor header above, I discovered that a trailing space after the closing "===" marker will disable its special function.]

Beware of problems with suffixes, like the .jpg file showing the APL code on the Diophantine page, have case-sensitive names and insist on a lower-case suffix like "jpg".

Also, the wiki fails silently for files with underscores in the name, like this: seemingly_ordinary_file.txt.

Also, consider saving images, like graphs you generate in the J-language, as Portable Network Graphics or ".png" files as these are sometimes more efficient than .jpgs. Take a look at the J-language code at the top of this picture, which is the same as the "miscellaneous picture" linked to below, for an example of saving a picture in this format.

There is a wiki command "<<TableOfContents>>" that I find useful: it makes a table of contents from all your section headings. Take a look at the source to see how this works.

Major section titles are marked by double =s and minor ones by triple =s like this:

== Major ==
=== Minor ===

As you can see from the table-of-contents at the top of this page, the major sections are followed by their associated minor sections, indented.

### User Name and Directories

Of course, you need to register to be able to edit pages. The wiki wants you to use a "camel-case" name like "DevonMcCormick" and this can be used as a sub-directory name to group your own pages. You create a new page simply by entering it into your browser's address bar once you've registered, like this: http://www.jsoftware.com/jwiki/DevonMcCormick/WikiTips.

Link to another page on the J-Wiki like this:

[[NYCJUG/linearDiophantineEquations|Diophantine equations]]

This will prefix "NYCJUG" with the current high-level URL "http://www.jsoftware.com/jwiki" and will make the text after the "pipe" a blue link as seen in the reference to "linearDiophantineEquations" above.

The same applies when linking to any URL in general like this:

[[http://www.jsoftware.com/jwiki/Essays/Text_Formatting|essay]]

will display the single word in brackets after the pipe, "essay" in this case, instead of the text of the link, like so. In general, you can represent a link by a "blue" word by bracketing the wiki command with a word or phrase following it, separated by a pipe, e.g.

[[attachment:miscPic.jpg|miscellanous picture]]

looks like this: miscellanous picture.

Note that this method used with a picture makes it a link on which one must click rather than showing it in-line, using syntax like the following (be sure not to put a space between the colon and the file name):

{{attachment:sineEyesWBrows_66.jpg}}

like this .

==== Linking Within a Page ==== You can establish an anchor-point in the middle of a page to allow references directly to a sub-section:

<<Anchor(anchorExample)>>

and link to it like this:

[[DevonMcCormick/WikiTips#anchorExample]]

• However, <<Anchor>> is useful for jumping to a point within a section, as shown in the following example. -- DevonMcCormick 2010-01-16 19:34:00

This links to the bottom of my test page.
This links, by means of an anchor point, to an example of symbolic understanding using an explanation of dyadic transpose.
This attempts to link, by using the section name including embedded spaces, to an example of symbolic understanding using an explanation of dyadic transpose, but it fails.
This attempts to link, by means of the section title with "%20" replacing the embedded spaces, to an example of symbolic understanding using an explanation of dyadic transpose, but it fails.

You have to save the page in order to test linking to the anchor.

### Aiding Keyword Searches

To help people to find your page, you may want to include a list of keywords that you think likely to be used as search phrases to locate your topic. This is particularly important for a language like J in which we have such a specialized, technical vocabulary. So, for this page, I put this

#pragma keywords hints, editing gotchas, adumbration, tip-off, warning, observation, wrinkle

at the top as the comma-separated list after "keywords" are relevant phrases which may not otherwise appear in the text.

Sometimes we use unusual, mathematics-based, terminology in the J-language world so adding likely synonyms can help people discover what we mean. Also, since anyone can edit these pages, other people can add keywords which seem natural to them but which you may not have considered.

### Tables

You can insert a table

 Date Page Change 20090907 WikiTips Added examples of anchors and tables 20090903 NYCJUG/2009-08-11 Updated "Terser Is Better" essay

like this:

||'''Date'''||'''Page'''||'''Change'''||
||20090907||[[DevonMcCormick/WikiTips|WikiTips]]||Added examples of anchors and tables||
||20090903||NYCJUG/2009-08-11||Updated "Terser Is Better" essay||

You can also create your table in MS Word and import it in the GUI editing mode but this brings in a lot of cruft. Do this only for large or complex tables which you do not plan to edit in the wiki text-editing mode.

## Special Characters

This wiki has a number of conventions for entering "special" characters - I'm still unaware of most of them. However, the ones with which I'm familiar are mentioned here.

### Emphasis

Italics are applied to text delimited by pairs of single quotes (''text to italicize''); bolding requires triplets of single quotes ( '''text to bold''').

### Entering Code

Enter code or anything else you want to see "as is", like the wiki markup above, by enclosing it in triple curlies (curly braces, i.e. "{" and "}"), like this:

{{{
NB.* MyStrings.ijs: (text) string handling fns.

tc =: # (i.~{.]) [: }. (,#) {~^:a: 0:

NB.* lineNoWiderThan: Given: a string of words separated by blanks and a positive integer w of the desired width. Replace appropriate blanks in the string by the newline character LF , so that lines are no wider than w and each line contains all the words that fit within the line.

NB. This is a renamed "fmt" function from an essay on text formatting by
NB. Roger Hui, at http://www.jsoftware.com/jwiki/Essays/Text_Formatting.
lineNoWiderThan=: 4 : 0
e=. (' ' I.@:= y),#y
LF (e {~ <: tc e I. (x+2)+}:_1,e)} y
)

end =: #@] ,~ ' ' I.@:= ]
candidates =: ] I. 2&+@[ + }:@(_1&,)@]
ix =: [ (<:@tc@candidates { ]) end
NB.* lineNoWiderThant: tacit version of "lineNoWiderThan".
lineNoWiderThant =: LF"_ix]
}}} 

A change in the Wiki format now (after about 2008) messes up in-line triple-curlies, so an expression starting like this

{{{diag0=: (<0 1)&|:     NB. diagonal of matrix
}}}

no longer works properly. You have to add a line break after the opening triple-curly like this:

{{{
diag0=: (<0 1)&|:     NB. diagonal of matrix
}}}

to fix it.

### Subscript and Superscript

We may designate partitions from a1 to am. We may indicate transpose by AT.

a,,1,, to a,,m,,
A^T^

This latter convention messes up embedded J code when we use two power carets (^) in one line. For example:

Illustrating the power conjunction with a noun argument - u N:2 x - and with a verb causes the text between the carets to be smaller and raised up: u N:v x.

### Symbolic Notation

We can insert mathematical symbols using a "LaTex" insertion. This is helpful if you are familiar with LaTex but can be very frustrating. For instance, a blank line (except after something like "%%end-prologue%%") will cause a cascade of errors that will fail to illuminate the simple root cause of the problem. Also, some LaTex is implemented but some is not; for instance, \hspace works but \vspace doesn't.

## Date and Time (attempts)

[[#time:1|12:13:00-0500]]
• 2013-06-06 17:08:00 - OK:

<<DateTime(2013-06-06T12:08:00-0500)>>

## Create a button

<<NewPage(NewNewsPostTemplate,Post a new item,@SELF,%Y-%m-%d.%H%M%S)>>

--- -- -- DevonMcCormick 2013-06-06 14:09:02

DevonMcCormick/WikiTips (last edited 2013-09-13 17:55:29 by DevonMcCormick)