To LUGNET HomepageTo LUGNET News HomepageTo LUGNET Guide Homepage
 Help on Searching
 
To LUGNET News Traffic PageSign In (Members)
 Publishing / FTX / User Guide / all


This User Guide helps you get started with FTX. (You may choose to view this entire guide on one big page or output the printer-friendly version.) There is also an FTX Quick-Start page for the extremely impatient.


The basics of page building
Special formatting
LEGO-related features
LUGNET-related features
Advanced topics
More information

All of the pages in this FTX User Guide are themselves FTX documents.



Basic page building

Before you begin
  • Are you a LUGNET Member? Only LUGNET Members can create web pages on LUGNET. (Sign Up)
  • Are you signed in? Signing in allows you to create pages using your Member ID. (Sign In)

Starting a new page

Once you’re a LUGNET Member and are signed in, starting a new page on LUGNET is easy:
  1. Imagine a location for your new page.
  2. Go to that location in your web browser.
  3. Click the Start This Page button.
It really is that easy.

Well, almost. There are some page location restrictions: your pages must have URLs which include your Member ID, and they should conform to existing divisons of the LUGNET website.

Let’s start with a very simple example. Open the following location in your web browser, replacing 1234 with your own Member ID number):
   http://www.lugnet.com/~1234/
You should see a page with the text “This page is empty” and a button labeled “Start This Page.” (If you don’t see the button, make sure that you are properly signed in and that you have typed your LUGNET Member ID correctly in the page’s location.

Now click the Start This Page button. A screen with an editing box will appear.


Typing in your page

For the most part, whatever you type into the editing box is what will appear on your page. For example:

Hello and welcome to my new page on LUGNET.  This is my page
and I can put lots of neat things on it and link to other
neat things.

This is the second paragraph of my new page.  I'll come back
later and replace this with something more interesting.


Previewing your page

When editing pages on LUGNET, you always have the option to “preview” your changes before committing to them. Below the editing box, notice the three buttons labeled Preview, Save, and Cancel.

Click the Preview button. A formatted version of your content will appear, below which will be a new editing box. Feel free to make further changes, then click Preview again. Continue this process until you’re satisfied and ready to save your page.


Saving your page

Once your page is saved to the server, other people can view your page, but only you can make changes to it.

Click the Save button which appears below the editing box. (You may need to scroll your web browser window downward if you have created a very tall page.) Now your formatted page appears, with the addition of an Edit This Page button for future changes. As the owner of this page, only you will see this button.


Editing your page

Any time you visit your own pages, you can change them (assuming of course that you’re signed in). Alterations are as simple as clicking a button, typing your changes, and clicking another button.

To begin editing, click the Edit This Page button at the bottom of the page. A familiar editing box will appear. There, make whatever changes you wish.

Click Preview to see the effects of your changes or Save to commit your changes. Alternatively, you could click Cancel to abandon your changes and redisplay the most recently saved version of your page.


Back up to User Guide contents



Naming your pages

Let’s assume your LUGNET Member ID number is 1234. When you publish pages, how do you know where your pages should “live” on LUGNET? How do you choose their URLs or web addresses?

The URLs of your pages can be short and simple, for example:
   http://www.lugnet.com/~1234/
or long and complex:
   http://www.lugnet.com/org/us/nelug/~1234/meeting/2000-05-25/notes
But how do you know exactly what is most appropriate? Below is a general framework for LUGNET Member page URLs -- this should help you to recognize proper form:
   http://www.lugnet.com/category/~yourid/subdir/pagename
where:
  • yourid is your LUGNET Member ID#
  • category is an existing LUGNET web/news category (optional)
  • subdir is a subdirectory you define (optional)
  • pagename is the page name you define (optional)
Together, this information should indicate to others what the content on your page may be.


Examples

To get a better sense for possibilities, please study these examples (which also use the Member ID# 1234):
   http://www.lugnet.com/~1234/
   http://www.lugnet.com/~1234/AboutMe
   http://www.lugnet.com/~1234/Ideas/
   http://www.lugnet.com/~1234/Ideas/Modular/LandingGear
   http://www.lugnet.com/faq/~1234/acronyms
   http://www.lugnet.com/robotics/tele/~1234/webcam/code
   http://www.lugnet.com/castle/org/cw/~1234/
   http://www.lugnet.com/cad/mlcad/~1234/HowTo/Install
   http://www.lugnet.com/loc/us/ma/bos/~1234/map
   http://www.lugnet.com/org/us/nelug/~1234/meeting/2000-05-25/
   http://www.lugnet.com/org/us/nelug/~1234/meeting/2000-05-25/notes
You may be wondering, “Where’s the index.html?” Internally, page URLs ending in / are stored as index.ftx files; any page URLs ending in /foo would be stored as foo.ftx files. Thus, the following two URLs represent the same page:
   http://www.lugnet.com/~1234/Ideas/index   (internally /~1234/index.ftx)
   http://www.lugnet.com/~1234/Ideas/        (internally /~1234/index.ftx)
while these two URLs represent different pages:
   http://www.lugnet.com/~1234/Ideas/   (internally /~1234/Ideas/index.ftx)
   http://www.lugnet.com/~1234/Ideas    (internally /~1234/Ideas.ftx)

Page and directory names

The following characters are allowed in your page and directory names:
  • Lowercase letters a-z
  • Uppercase letters A-Z
  • Numeric digits 0-9
  • Hyphen -
  • Underscore _
  • Tilde ~ (only as Member ID prefix)
  • Forward-slash / (only as directory separator)

Calendar dates

When writing calendar dates in directory or page names, always use a fixed-size international numeric format with the largest unit first so that a regular alphabetic sort will put the names into proper chronological order.

For example:

Date
   
   Good
   
   Bad
 
May 25, 2000
   
   2000-05-25
2000/05/25
   
   5-25-2000
05-25-2000
25-05-2000
May-25-2000
2000-May-25
 
December 11, 1998
   
   1998-12-11
1998/12/11
   
   12-11-1998
11-12-1998
Dec-11-1998
1998-Dec-11


Back to the main User Guide page



Text features

Beyond writing simple paragraphs of text, you can refine certain text characteristics by inserting special characters. This is part of what we refer to as FTX code.


Boldface and italics

Curly braces { } make italics and square brackets [ ] make boldface. The two can even be combined if necessary.

You write...

This is {italics} and this is [boldface] and this is {[both]}.

You get...

This is italics and this is boldface and this is both.


If you wanted to show an actual curly brace or square bracket character, you could do so by putting a “backtick” (reverse singe quote) ` in front of it, like this:

You write...

I can write [boldface] and brackets `[ `].  I can write {italics} and
curly braces `{ `}.

You get...

I can write boldface and brackets [ ]. I can write italics and curly braces { }.


Underlining

Underlined text should be used very sparingly because it can visually be confused with hyperlinks. Still, it may be necessary for things like acronym expansions or technical bibliographies.

Underlining is turned on by inserting an underscore character and turned off again by a second. For example:

You write...

Every _other_ word _in_ this _sentence_ is _underlined_.  Every other _word
pair_ in this _silly sentence_ is underlined.

You get...

Every other word in this sentence is underlined. Every other word pair in this silly sentence is underlined.


Underlining is most helpful when applied to single-characters or very short runs of characters, for example in the expansion of abbreviations or acronyms:

You write...

NELUG is the _N_ew _E_ngland _L_EGO _U_sers _G_roup.

You get...

NELUG is the New England LEGO Users Group.


As with curly braces and square brackets, if you wanted to show an actual underscore character, simply prefix it with the ` character.



Hyperlinks

Including hyperlinks in your pages is as easy as enclosing URLs in angle brackets.


Linking to other websites

To make hyperlinks to pages on other websites (that is, other than pages on www.lugnet.com), enclose the complete URL (including the http:// part) in angle brackets, for example:

You write...

Visit <http://www.lego.com/> for more information.

You get...

Visit http://www.lego.com/ for more information.


If you want to use a link label, include it just after the URL, but before the closing angle bracket, for example:

You write...

Visit <http://www.lego.com/ The Official LEGO World Wide Web Site> for more
information.

You get...

Visit The Official LEGO World Wide Web Site for more information.


Linking to pages or resources on LUGNET

When linking to your own pages on LUGNET (or other members’ pages), simply enclose page URLs in angle brackets, for example:

</~1234/>

or

</~1234/CurrentProjects>


As in HTML, write URLs relative to the page or directory in which they reside. For example:


When linking from:
   To:
   Use this:
 
/~1234/foo/
   /~1234/foo/bar
   bar
 
/~1234/foo/bar
   /~1234/foo/zot
   zot
 
/~1234/foo/zot
   /~1234/foo/
   ../
 
/~1234/foo/
   /~1234/gonk/zort
   ../gonk/zort
 
/~1234/foo/
   /~4321/gonk/
   /~4321/gonk/


If you don’t see a way to shorten a URL, don’t worry; the longer version will always work fine.


Linking to E-mail addresses

To make an e-mail address link, prefix it with mailto:, enclose this in angle brackets, and add your link text. For example:

You write...

Please <mailto:me@myisp.com let me know> what you think!

You get...

Please let me know what you think!



Images

Including images in your pages is very similar to including links to other pages. Assuming the image is one of your own or one you have permission to link to, simply enclose its URL in double angle brackets, for example:

You write...

<<http://www.baseplate.com/ideas/human-scale/clock/clock-hands.jpg>>

You get...




Note: LUGNET automatically looks up the width and height (in pixels) of your image. Also be aware that border lines will not appear around your images.


Images as links

You may want to make your image “clickable.” That is, when a visitor clicks on your image, it results in the display of new content such as a larger view of your picture, or perhaps another page.

To make a linked image, write the destination URL (the “target”) between the first and second opening angle brackets, for example:

You write...

<http://www.baseplate.com/ideas/human-scale/clock/
 <http://www.baseplate.com/ideas/human-scale/clock/clock-hands.jpg>>

You get...




Note: If such links become illegibly long, you can split them at a whitespace character, as shown above.


Adding alternate text

Some web browsers can display text labels in place of images they are unable to show. These labels are sometimes referred to as “alt tags” and may also show up in a little box above your cursor as it passes over an image.

To include alternate text with your image, type the text inside the angle brackets, after the image URL, for example:

You write...

<<http://www.baseplate.com/ideas/human-scale/clock/clock-hands.jpg Clock>>

You get...

Clock


Adding alternate text to linked images is similar:

You write...

<http://www.baseplate.com/ideas/human-scale/clock/
 <http://www.baseplate.com/ideas/human-scale/clock/clock-hands.jpg Clock>>

You get...

Clock


About the notation: Some logic for the curious

If you are familiar with HTML, this double angle bracket notation may seem a bit odd. Let’s back up for a moment and revisit links. If you look at their general form in FTX, you’ll see a pattern of text:

      <url label>

The URL is a target destination. If present, a label will be displayed (typically underlined text in blue or purple) in place of the actual URL.

Applying this to an image on the page, the same holds true:

      <url <image>>

Now, if you wanted to show an image with no target URL, you would simply omit that portion, leaving you with this:

      <<image>>

And if you wanted to show alternate text, you would use this:

      <<image label>>

So, the FTX notation is actually quite consistent: In each case, an opening angle bracket is followed by a URL, which is optionally followed by an indication of what to display, followed finally by a closing angle bracket.



Section headlines

To make a bold section header, isolate the text and underline it with equal signs (=). Be sure it’s followed by a blank line, for example:

You write...

This is a large section headline
================================

etc. etc. etc.

You get...

This is a large section headline

etc. etc. etc.


To make a lesser header, type it on its own line, followed by a line of dashes (-), for example:

You write...

This is a medium section headline
---------------------------------

etc. etc. etc.

You get...

This is a medium section headline

etc. etc. etc.


To make a minor section header, type it as its own paragraph, with a blank line both above and below it. Then invoke boldface, for example:

You write...

[This is a minor section]

etc. etc. etc.

You get...

This is a minor section

etc. etc. etc.



Horizontal rules

To make a horizontal rule (a full-width thin line) on your page, simply type a line of -’s as its own paragraph. For example:

You write...

last line of the previous paragraph

------------------------------------------------------------

first line of the next paragraph

You get...

last line of the previous paragraph

first line of the next paragraph



Including special characters

In FTX, as in a word processor, many non-ASCII characters like ñ, ß, ™, ®, ©, §, and ½ can be input directly. You may need the assistance of a “key caps” or “character map” tool to locate and paste these characters, but if you can see them in your editing box, you can make them part of your pages.

In Microsoft Windows®, for example, you can use the Alt key and the 10-key pad to enter these symbols directly. (Hold down the Alt key while typing the character’s four-digit code on the 10-key pad, then let up the Alt key.) A few examples are shown below.

ñ Alt+0241
   ß Alt+0223
   ™ Alt+0153
   ® Alt+0174
   © Alt+0169
   § Alt+0167
   ½ Alt+0189

A complete character table appears on the FTX quick reference card.



Line breaks

Manual line breaks

In FTX, multiple lines in a paragraph are normally adjoined as if they had been written on a single line. When a paragraph is sent to a web browser, the web browser decides where to break the paragraph back into lines based on the width of the available area.

If you ever need to break a line at a specific point, the FTX line-break character is:
   ¬
It is at position #172 in the standard ISO-8859-1 character set. In Microsoft Windows®, you can input this character by typing 0172 on the 10-key pad while holding down the Alt key. You may also be able to paste it from a “key caps” or “character map” program. Here is an example:

You write...

[Ingredients:]¬2 slices bread¬1 tbsp. peanut butter¬1 tbsp. grape jelly

[Preparation:]¬
Apply peanut butter to first bread slice¬
Apply jelly to second bread slice¬
Align bread slices, sticky sides facing¬
Press gently, until secure

You get...

Ingredients:
2 slices bread
1 tbsp. peanut butter
1 tbsp. grape jelly

Preparation:
Apply peanut butter to first bread slice
Apply jelly to second bread slice
Align bread slices, sticky sides facing
Press gently, until secure


Automatic line breaks

If you want to write a large block preformatted text, you can begin each line with a colon (:) followed by a space, for example:

You write...

: 1 (one) 32-oz. jar Claussen® Halves
: 2-3 Habenero peppers, sliced
: 3-4 Serrano peppers, sliced
: 2-3 Jalapeño peppers, sliced
: 12 cloves garlic, pressed or finely chopped
: 1 tbsp. crushed red pepper flakes

You get...

1 (one) 32-oz. jar Claussen® Halves
2-3 Habenero peppers, sliced
3-4 Serrano peppers, sliced
2-3 Jalapeño peppers, sliced
12 cloves garlic, pressed or finely chopped
1 tbsp. crushed red pepper flakes


If you want to write a large block of text in italics, you can begin each line with a semicolon (;) followed by a space, for example:

You write...

; A young builder from west Tennessee
; Declared, "Bricks are too chunky for me!"
;   He picked up a plate
;   And began to create
; A great landscape divided by three.

You get...

A young builder from west Tennessee
Declared, “Bricks are too chunky for me!”
      He picked up a plate
      And began to create
A great landscape divided by three.


Individual line indentations are maintained when using these modes, as shown in the example above.



Lists

Bullet lists

Asterisks * in column 1 (followed by a space) make paragraphs into bullet lists:

You write...

* Milk
* Cheese
* Coffee

You get...
  • Milk
  • Cheese
  • Coffee

Numbered lists

Plus-signs + in column 1 (followed by a space) make paragraphs into upward-counting lists:

You write...

+ Pepperoni
+ Pineapple
+ Mushrooms

You get...
  1. Pepperoni
  2. Pineapple
  3. Mushrooms

Minus-signs - in column 1 (followed by a space) make paragraphs into downward-counting lists:

You write...

- Mushrooms
- Pineapple
- Pepperoni

You get...
  1. Mushrooms
  2. Pineapple
  3. Pepperoni

Definition lists

Equal-signs = in column 1 (followed by a space) make paragraphs into definition lists. Alternate your items between terms and defintions and use hanging indentation for long lines, for example:

You write...

= [brick]
= {n.} a thick building element, usually rectangular, having a rectangular
  grid of connecting studs on the top and connecting tubes on the bottom.
= [plate]
= {n.} a thin building element, often rectangular, having a rectangular grid
  of connecting studs on the top and connecting tubes on the bottom and
  measuring 1/3 the base thickness of a brick.
= [tile]
= {n.} a flat-topped plate; a thin building element, usually rectangular,
  having a smooth top surface void of any connecting studs and having
  connecting tubds on the bottom.

You get...

brick
n. a thick building element, usually rectangular, having a rectangular grid of connecting studs on the top and connecting tubes on the bottom.
plate
n. a thin building element, often rectangular, having a rectangular grid of connecting studs on the top and connecting tubes on the bottom and measuring 1/3 the base thickness of a brick.
tile
n. a flat-topped plate; a thin building element, usually rectangular, having a smooth top surface void of any connecting studs and having connecting tubes on the bottom.



Simple tables

The Basics

Tables of information or images can be included on your page by using the following method: A tilde (~) character followed by a space at the beginning of a new line indicates a column of data. A paragraph break signals a new row. For example:

You write...

~ [Number/Name]
~ [Year]
~ [Pieces]
~ [Missing]

~ 6054 Forestmen's Hideout
~ 1988
~ 198
~ box

~ 6066 Camouflaged Outpost
~ 1987
~ 211
~ instructions

~ 6071 Forestmen's Crossing
~ 1990
~ 203
~ front box flap

~ 6077 Forestmen's River Fortress
~ 1989
~ 348
~ box, baseplate

You get...

Number/Name
   Year
   Pieces
   Missing
 
6054 Forestmen’s Hideout
   1988
   198
   box
 
6066 Camouflaged Outpost
   1987
   211
   instructions
 
6071 Forestmen’s Crossing
   1990
   203
   front box flap
 
6077 Forestmen’s River Fortress
   1989
   348
   box, baseplate


Notice the use of bolding brackets in the column heads.


Including images

Including images in tables is easy once you know how to write image URLs. For example, here is a simple table illustrating three classes of LEGO® building elements:

You write...

~ <<LDrawPart(3003:15)>>
~ [brick]¬
  {n.} a thick building element, usually rectangular, having a rectangular
  grid of connecting studs on the top and connecting tubes on the bottom.

~ <<LDrawPart(3022:15)>>
~ [plate]¬
  {n.} a thin building element, often rectangular, having a rectangular grid
  of connecting studs on the top and connecting tubes on the bottom and
  measuring 1/3 the base thickness of a brick.

~ <<LDrawPart(3068:15)>>
~ [tile]¬
  {n.} a flat-topped plate; a thin building element, usually rectangular,
  having a smooth top surface void of any connecting studs and having
  connecting tubes on the bottom.

You get...


   brick
n. a thick building element, usually rectangular, having a rectangular grid of connecting studs on the top and connecting tubes on the bottom.
 

   plate
n. a thin building element, often rectangular, having a rectangular grid of connecting studs on the top and connecting tubes on the bottom and measuring 1/3 the base thickness of a brick.
 

   tile
n. a flat-topped plate; a thin building element, usually rectangular, having a smooth top surface void of any connecting studs and having connecting tubes on the bottom.


Optional Features

Special formatting characters can be used after the ~ to specify vertical or horizontal table-cell alignment:
  • ~^ align cells top
  • ~- align cells vertically
  • ~v align cells bottom

  • ~< flush cells left
  • ~| center cells horizontally
  • ~> flush cells right
These can be combined, for example:
  • ~<^ top left
  • ~|- center both horizontally and vertically
When alignment is specified, it applies to all further table cells in the same column of the table. Thus, in a typical table, you need only specify alignment once, in the first row.

The default alignment (if none is specified explicitly) is ~<-, which means “align content of columns to the left and center content of rows vertically.” The most common override is ~^, which means “align content of columns to the left and align content of rows to the top.”

Nested tables (that is, tables within tables) are not supported.

Below is a table displaying three Cool LEGO Site of the Week buttons. Note the use of ~v| to align the data to the bottom of the cells and to center the data horizontally within the cells.

You write...

~v| <</cool/clsotw-round-100x100.gif>>¬100x100 pixels¬3 KB
~v| <</cool/clsotw-round-75x75.gif>>¬75x75 pixels¬2 KB
~v| <</cool/clsotw-round-50x50.gif>>¬50x50 pixels¬1 KB

You get...


100x100 pixels
3 KB
   
75x75 pixels
2 KB
   
50x50 pixels
1 KB


Further Examples

Examples of higher complexity are outside the scope of this brief User Guide. However, here is a short list of external examples which you may wish to study:
  • Two-column narrative with side labels: Input / Output
  • Three-column narrative with thumbnails in sidebar: Input / Output
  • Flex-column thumbnail grid with text: Input / Output
  • Three-column narrative with bottom labels: Input / Output



Computer code

Word mode

To express a word or phrase in a computer-style (or typewriter-style) typeface, for example a key on the keyboard or something you would like a reader to type, use a pair of vertical bar characters around words. Vertical bar characters in FTX activate HTML’s <TT> (teletype) font, for example:

You write...

Press the |Enter| key.

You get...

Press the Enter key.


Since the vertical bar is special, you need to use a backtick if you want to display an actual vertical bar character -- just as you would for {, }, [, ], <, and >. For example:

You write...

I can write |teletype stuff| and I can write vertical bars `|.

You get...

I can write teletype stuff and I can write vertical bars |.


Between vertical bars, {, }, [, ], <, >, and _ are automatically protected from their normal FTX interpretations. That is, in the context of displaying computer code, { and } do not produce italics, [ and ] do not produce boldface, < and > do not produce links, and pairs of _ do not produce underlined text. Instead, these characters appear naturally, for example:

You write...

The size is given by |$foo_bar->[zot]{glort}|, if present.

You get...

The size is given by $foo_bar->[zot]{glort}, if present.


However, when writing computer code in word mode (using a delimited pair of vertical bar characters), you do still need to use a backtick character for ` and | inside a pair of vertical bars, for example:

You write...

The vector |$C| is computed as |$A`|$B|.
By far my favorite shell idiom is |...`|sort`|uniq -c`|sort -n|.

You get...

The vector $C is computed as $A|$B. By far my favorite shell idiom is ...|sort|uniq -c|sort -n.


Block mode

You can also express entire blocks of text as pre-formatted text in the teletype font by using a vertical bar followed by a space at the beginning of each such line, for example:

You write...

| int main(int argc, char *argv[])
| {
|    ...
| }

You get...
int main(int argc, char *argv[])
{
   ...
}
In block modes, all characters on the line (after the initial vertical bar and accompanying space character) are protected from their normal FTX interpretations -- even ` and |. Thus, you can take any block of computer code and prefix it with a vertical bar (and a space) without any worries.

Block modes require a space character after the initial vertical bar in order to prevent accidental interpretation of word-mode (delimited pairs of vertical bars) as block mode when a short computer word or phrase in a regular paragraph happens to appear at column 1. This space character is purely syntactical and is not treated as part of your actual line. Subsequent space characters, however, are treated as part of your actual line.


Double block mode

You can use two vertical bars followed by a space at the beginning of each line in a paragraph to show that block in a lightly shaded background with a thin border, for example:

You write...

|| int main(int argc, char *argv[])
|| {
||    ...
|| }

You get...

int main(int argc, char *argv[])
{
   ...
}



LEGO Sets

Inserting LEGO sets in your pages is easy. All you need is the set number from LUGNET’s LEGO Set database.

You write...

<<LEGOSet(6399)>>

<<LEGOSet(6990)>>

<<LEGOSet(6991)>>

You get...


    6054 Forestmen's Hideout
198 elements, 2 figures, US$17.50, 1988
LEGO > SYSTEM > Castle > Forestmen


    6066 Camouflaged Outpost
211 elements, 6 figures, US$23, 1987
LEGO > SYSTEM > Castle > Forestmen


    6071 Forestmen's Crossing
203 elements, 5 figures, US$28.50, 1990
LEGO > SYSTEM > Castle > Forestmen


Beware of ambiguities

The LEGO Company has, unfortunately, on occasion released two or more sets under the same set number. For example, LEGO set #6848 was used in 1985 and then again in 1988!


    6848 Strategic Pursuer
58 elements, 1 figure, 1988
LEGO > SYSTEM > Space > Futuron
 

    6848 Interplanetary Shuttle
50 elements, 1 figure, 1985
LEGO > SYSTEM > Space > {Classic}

Stranger things have happened. In 1989, a value pack numbered #1974 used that same number #1974 for all three of the constituent sets within it!


    1974 Bonus Pack
158 elements, 4 figures, US$10, 1989
LEGO > SYSTEM > Bonus Packs
 

    1974 Flyercracker U.S.A.
1 figure, 1989
LEGO > SYSTEM > Town > {}
 

    1974 Smuggler's Hayride
48 elements, 2 figures, 1989
LEGO > SYSTEM > Castle > Forestmen
 

    1974 Star Quest
1 figure, 1989
LEGO > SYSTEM > Space > Futuron

And in 2000, the DUPLO Egg set #2751 actually came in four different flavors:


    2751 {DUPLO egg puppy}
5? elements, 0 figures, US$4, 2000
LEGO > DUPLO > {Eggs}
 

    2751 {DUPLO egg racecar}
1 figure, US$4, 2000
LEGO > DUPLO > {Eggs}
 

    2751 {DUPLO egg baby stroller}
1 figure, US$4, 2000
LEGO > DUPLO > {Eggs}
 

    2751 {Little Forest Friends egg}
1 figure, US$4, 2000
LEGO > DUPLO > Little Forest Friends > {Eggs}


Avoiding ambiguities

In cases of ambiguity, an appendage is applied to the set number. A fully unambiguous Set ID consists of the set number (for example 1974), followed by an underscore (“_”), followed by an issue number (almost always 1, but in the case of set #1974, it’s 1, 2, 3, or 4).

You write...

<<LEGOSet(1974_4)>>

You get...


    1974 Star Quest
1 figure, 1989
LEGO > SYSTEM > Space > Futuron

How do you figure out what number to put after the underscore? You look at the very end of the URL in the set database and use that. For example, if this is the URL of the set that you want to show:

      http://guide.lugnet.com/set/6861_2

then you would write:

      <<LEGOSet(6861_2)>>



LEGO Elements

Inserting pictures of LEGO elements in your pages is easy if you know the LDraw part codes. Everything you ever wanted to know about LDraw part codes and color numbers is available in Partsref.
  • 2337 is the LDraw part number for “Windscreen 4 x 4 x 2 Canopy Extender”
You write...

<<LDrawPart(2337)>>

You get...





By default, a generic color (a sort of off-white, cream-colored beige) is used. If you know LDraw color numbers, you can apply colors.
  • 2337 is the LDraw part number for “Windscreen 4 x 4 x 2 Canopy Extender”
  • 46 is the LDraw color number for transparent yellow
You write...

<<LDrawPart(2337:46)>>

You get...




Multiplying Parts

If you want to show several copies of an element, you can apply a repeat count. Ever wondered what a dozen transparent neon yellow/green skeletons might look like?
  • 6260c01 is the LDraw part number for “Minifig Skeleton (Shortcut)”
  • 42 is the LDraw color number for transparent neon yellow/green
  • 12 is the repetition count
You write...

<<LDrawPart(6260c01:42:12)>>

You get...




Simple Layout

And if you’re familiar with FTX tables, you can make cute little arrangements of bricks.
  • 3001, 3002, 3003, 3004, 3005, and 3024 are the part numbers
  • 15 is the LDraw color number for white
  • 1, 2, 3, 4, 6, and 7 are repetition counts
You write...

~| <<LDrawPart(3001:15:1)>>

~| <<LDrawPart(3002:15:2)>>

~| <<LDrawPart(3003:15:3)>>

~| <<LDrawPart(3004:15:4)>>

~| <<LDrawPart(3005:15:6)>>

~| <<LDrawPart(3024:15:7)>>

You get...


 

 

 

 

 



Arch Geometry

You write...

~|
~| [3 long]
~| [4 long]
~| [6 long]
~| [8 long]

~| [1 tall]
~| <<LDrawPart(4490:7)>>
~| <<LDrawPart(3659:7)>>
~| <<LDrawPart(3455:7)>>
~|

~| [2 tall]
~|
~| <<LDrawPart(6182:7)>>
~| <<LDrawPart(3307:7)>>
~| <<LDrawPart(3308:7)>>

You get...


   3 long
   4 long
   6 long
   8 long
 
1 tall
   
   
   
   (n/a)
 
2 tall
   (n/a)
   
   
   


Rainbow of Gems, Rocks, and Crystals

You write...

~| <<LDrawPart(30153:47)>>
~| <<LDrawPart(30153:41)>>
~| <<LDrawPart(30153:33)>>
~| <<LDrawPart(30153:34)>>
~| <<LDrawPart(30153:42)>>
~| <<LDrawPart(30153:46)>>
~| <<LDrawPart(30153:57)>>
~| <<LDrawPart(30153:36)>>

~| <<LDrawPart(52:47)>>
~| <<LDrawPart(52:41)>>
~| <<LDrawPart(52:33)>>
~| <<LDrawPart(52:34)>>
~| <<LDrawPart(52:42)>>
~| <<LDrawPart(52:46)>>
~| <<LDrawPart(52:57)>>
~| <<LDrawPart(52:36)>>

~| <<LDrawPart(30213:47)>>
~| <<LDrawPart(30213:41)>>
~| <<LDrawPart(30213:33)>>
~| <<LDrawPart(30213:34)>>
~| <<LDrawPart(30213:42)>>
~| <<LDrawPart(30213:46)>>
~| <<LDrawPart(30213:57)>>
~| <<LDrawPart(30213:36)>>

You get...


   
   
   
   
   
   
   
 

   
   
   
   
   
   
   
 

   
   
   
   
   
   
   


World Flags

You write...

~| Sweden¬<<LDrawPart(777p02:15)>>
~| Finland¬<<LDrawPart(777p04:15)>>
~| Denmark¬<<LDrawPart(777p03:15)>>
~| Austria¬<<LDrawPart(777p06:15)>>
~| Germany¬<<LDrawPart(777p01:15)>>
~| Belgium¬<<LDrawPart(777p09:15)>>

~| UK¬<<LDrawPart(777p11:15)>>
~| France¬<<LDrawPart(777p07:15)>>
~| Italy¬<<LDrawPart(777p08:15)>>

You get...

Sweden

   Finland

   Denmark

   Austria

   Germany

   Belgium

 
UK

   France

   Italy



Road Signs

You write...

~|v No Left Turn¬<<LDrawPart(80039:15)>>
~|v No Parking¬<<LDrawPart(80045:15)>>
~|v No Thoroughfare¬<<LDrawPart(7284:15)>>
~|v Dangerous¬Intersection¬<<LDrawPart(81294:15)>>

You get...

No Left Turn

   No Parking

   No Thoroughfare

   Dangerous
Intersection



Technic Angle Connectors

You write...

~| #1¬<<LDrawPart(32013:15)>>
~| #2¬<<LDrawPart(32034:15)>>
~| #3¬<<LDrawPart(32016:15)>>
~| #4¬<<LDrawPart(924:15)>>
~| #5¬<<LDrawPart(32015:15)>>
~| #6¬<<LDrawPart(32014:15)>>

You get...

#1

   #2

   #3

   #4

   #5

   #6




LDraw Color Chart

This simple LDraw color chart is actually an FTX page. Here’s how it was done.


Black/Dark
   Medium
   Bright
   Light
   White
   Sand
 

0 - Black
   
8 - Dark Gray
   
7 - Gray
   
   
15 - White
   
 

   
   
5 - Dark Pink
   
   
13 - Pink
   
 

320 - Dark Red
   
   
4 - Red
   
   
   
335 - Sand Red
 

   
   
   
12 - Light Red
   
   
 

6 - Brown
   
   
   
   
   
 

   
   
25 - Orange
   
   
   
 

   
   
   
   
   
19 - Tan
 

   
   
14 - Yellow
   
18 - Light Yellow
   
   
 

   
   
10 - Bright Green
   
17 - Mint Green
   
   
 

   
2 - Green
   
   
   
   
378 - Sand Green
 

   
3 - Teal
   
11 - Turquoise
   
   
   
 

   
   
   
9 - Light Blue
   
   
379 - Sand Blue
 

   
   
1 - Blue
   
   
   
 

23 - Violet-Blue
   
   
   
   
20 - Light Purple
   
 

   
   
   
   
   
373 - Sand Violet
 

   
22 - Purple
   
   
   
   
 

   
   
39 - Trans-Gray
   
   
47 - Clear
 

   
   
36 - Trans-Red
   
   
 

57 - Trans-Orange
   
   
   
   
 

   
   
46 - Trans-Yellow
   
   
 

42 - Trans-Neon-Green
   
   
   
   
 

   
   
34 - Trans-Green
   
   
 

   
   
   
41 - Light Trans-Blue
   
 

   
   
33 - Dark Trans-Blue
   
   
 

21 - Glow in the Dark



Including news articles

Straight across

You can embed linked abstracts of LUGNET news articles right into your own pages using double angle brackets <<>>. For example, if you are viewing an article with this URL:
   http://news.lugnet.com/announce/?n=376
simply copy that URL and enclose it between double angle brackets -- but leave out the http://news.lugnet.com prefix:

You write...

<</announce/?n=376>>

You get...

  LUGNET Memberships
 
I'm happy to announce that formal LUGNET memberships are now available. :) Things won't be very fancy initially (no map or other web-toys yet) but this gets the ball rolling and begins to pave the way for much more to come later down the road. At (...) (25 years ago, 14-Nov-99, to lugnet.announce, lugnet.admin.general, lugnet.people) !! 


In a table

LUGNET news articles can even appear in table cells, for example:

You write...

~ Paul Foster saw on CNN Headline News that <http://www.legolandca.com/
  LEGOLAND California> is going to get a [liquor license] despite
  complaints...
~ <</legoland/california/?n=24>>

~ Joel Shafer has created a [piano-playing robot] which can play {"Mary
  Had a Little Lamb"} on his daughter's {Little Tykes} piano...
~ <</robotics/?n=6666>>

~ Paul Foster proposes the creation of a ["GMLUG"] (_G_reater _M_idwest
  _L_EGO _U_sers _G_roup)...
~ <</loc/us/wi/?n=22>>

You get...

Paul Foster saw on CNN Headline News that LEGOLAND California is going to get a liquor license despite complaints...
   
  liquor license
 
I was watching CNN headline news and the one liner news headlines at the bottom of the screen said that Legoland California is going to get a liquor license despite complaints. Anyone know anything more about this? (25 years ago, 1-Sep-99, to lugnet.legoland.california)  
 
Joel Shafer has created a piano-playing robot which can play “Mary Had a Little Lamb” on his daughter’s Little Tykes piano...
   
  Piano Player
 
I was inspired by Mario's piano player and conductor and decided that I had to build one. I built a robot that can play my daughter's "Little Tykes" piano. It currently plays mary had a little lamb. You can see some pics at: (URL) Shafer (...) (25 years ago, 2-Sep-99, to lugnet.robotics)  
 
Paul Foster proposes the creation of a “GMLUG” (Greater Midwest LEGO Users Group)...
   
  Greater Midwest Lego Users Group
 
Greetings AFOL in WI, IL, OH, IN, MN, IA, MI For those just joining us, we are discussing the formations of a Lego Users Group similar to (URL) and (URL) the proposal is for the new site to be located as gmlug.org. Now I realize that this group will (...) (25 years ago, 3-Sep-99, to lugnet.loc.us.wi, lugnet.loc.us.mn, lugnet.loc.us.il, lugnet.loc.us.oh, lugnet.loc.us.ia, lugnet.loc.us.mi, lugnet.loc.us.in)  



LUGNET member polls

Inserting a LUGNET member poll is easy. All you need is the poll number.

You write...

<<Poll(1)>>

You get...

LUGNET Member Poll
    
by Suzanne Rich Eaton
Why do you think The LEGO Company puts tiny holes in LEGO baggies?
to save money on plastic
because holy bags are easier to rip open
because holy bags are more rip-resistant
so little kids don’t suffocate
so the bags won’t explode in airplanes
those are the air-holes for minifigs!
so bags don’t muffle the magical clinking sound
to squeeze all the air out -- so it weighs less
View Results
    



Page transclusion: Including other pages

The FTX document format has a very special and almost magical content-inclusion feature: not only can you include images and news articles in the pages you create, but you can also include whole other pages in your pages!

In fact, doing this is extremely simple: Where you would normally link to a page using single angle brackets <>:

<example>

instead use double angle brackets <<>>:

<<example>>

It’s a little bit like embedding an image, except that the page you embed must be:
  1. Local to www.lugnet.com, and
  2. Written as an FTX document
Here is how the two lines above compare. First the regular link:

example

and now the included page:


This is a very short example page. Its only purpose is to be transcluded by another page. OK, this is the end of the page. Bye!


All right, now you’re back to the regular page. The small paragraph above is not truly part of the page you’re viewing, but actually a copy of a different page (click the link that says “example” or the little square box on the right to view that page all by itself).

Now here are a couple “real” examples, each pulling many separate pages together into one big page:

“Transclusion?”

Transclusion is a word coined by Project Xanadu® visionary Ted Nelson, who also coined the word Hypertext in 1963. Transclusion (also called transquoting) of materials is a form of transpublishing in which materials from one or more original sources are used or assembled at another location to make a new source.

Transclusion of text (or of a page) is different from inclusion of text (or of a page). Inclusion implies actually including a copy of the source material, while transclusion implies storing only a reference to it and assembling a copy of it only when it needs to be viewed.

Thus, when you transclude FTX pages, any changes made to the page referenced will automatically reflect in the page referencing it as well. (If you need to “lock in” to a particular historical revision of some FTX page, there is actually a way to do that, but it is beyond the scope of this tutorial.)

Note: When you transclude someone else’s FTX page on LUGNET, the copyright notice at the bottom of the webpage changes to include the author whose page you are transcluding.



Recovering older versions of your pages

All of your editing changes are stored in a compressed chronological log on the server. If you ever need to go back to a previous revision of a page to look something up or perhaps grab a portion of content which no longer exists on the page, it is possible.

First, you can view the raw FTX code for any FTX page by appending .ftx to the URL. For example, if you are viewing the page
   http://www.lugnet.com/~1234/foo/bar/gort
then you can also view that page’s FTX source by loading this URL:
   http://www.lugnet.com/~1234/foo/bar/gort.ftx
Similarly, you can view any revision of a any FTX page by appending $ followed by the revision number, for example:
   http://www.lugnet.com/~1234/foo/bar/gort$1
   http://www.lugnet.com/~1234/foo/bar/gort$2
   http://www.lugnet.com/~1234/foo/bar/gort$3
and so forth. You can omit the revision number if you would like to review a chronological list of revisions, for example:
   http://www.lugnet.com/~1234/foo/bar/gort$
Finally, you can append .ftx to an older revision’s URL if you would like to review the raw FTX code for an older revision, for example:
   http://www.lugnet.com/~1234/foo/bar/gort$1.ftx
   http://www.lugnet.com/~1234/foo/bar/gort$2.ftx
   http://www.lugnet.com/~1234/foo/bar/gort$3.ftx



Future directions

LUGNET’s FTX document format is designed to accommodate all sizes of documents -- from hundred-page tomes all the way down to single sentences, even single words. This flexibility yields potentially limitless uses: page templates, news content, weblogs, descriptive fields in databases, and countless other applications.

The following are under consideration as future possibilities related to LUGNET Member pages. Some are planned for activation soon, while others are still in the “idea” phase.
  • A continuous member-visible log/index of all changes/additions to pages, possibly served as an RSS (Rich Site Summary) document.
  • Automatic indexing -- so unlinked pages won’t get lost and to make outlines and forward/backward browsing easier.
  • Automatic linking to/from member homepages.
  • Indexing and searching of member-created page content.
  • Library of templates for photo galleries -- (document and narrate collections of images using a “wizard-style” approach, enabling a variety of alternative viewing options from a single starting point. May include thumbnailing, date-stamping, background decor, etc.
  • Templates for commerce-related activities -- (sales, auctions, locators, trading posts, etc.)
  • Templates for database-related activities -- (descriptive data repositories of, say, architectural styles/examples/models for the lugnet.build.arch group, etc.)
  • Templates for weblog-style activities -- with RSS integration
  • Templates for discussion-related activities -- (light integration of the .ftx document format with newsgroup postings)
  • Support for other (non-.ftx) data formats (such as .txt; .dat for LDraw models, parts, etc.; some .html; and potentially raw images)
  • Uploading/downloading large content batches (via zipfile or tarball).



FTX Quick Reference Card

Here is an FTX reference card suitable for printing. Click on the sample shown below to download a high-quality version. The intended output size is 4” x 3½” (10 cm. x 9 cm.) unfolded or 2” x 3½” (5 cm. x 9 cm.) folded.

Click to download printable version
Click to download printable version
   
   Image details:
600 dpi
2400x2100 pixels
GIF89a file format
108 KB



FTX FAQ: Answers to Frequently Asked Questions

FTX is a text-based publishing format for making web pages on LUGNET. Pages can contain text, lists, images, hyperlinks, and more. For detailed information, please see the FTX User Guide.


1. Can I store my pictures on LUGNET?

Not currently. The associated costs are relatively high, but falling. Users are encouraged to investigate image-hosting services on the Internet, most notably Kevin Loch’s BrickShelf.com.

Since your images will still appear to be on LUGNET as they load into your member pages, you should always make sure that you have permission to make direct embedded links to any images that you include.


2. What about copyrights and disclaimers and stuff?

To some extent, these are taken care of for you automatically. LUGNET shows a general legal disclaimer and copyright notice at the bottom of every page you create. (This does not necessarily protect you from liability of copyright infringement, however; you still need to act responsibly.)

If you own an image or a body of text, or if it is in the public domain (meaning that it is not copyrighted), then of course you may use it. If not, always obtain permission from the copyright owner prior to using something which you do not own.

An exception is linking to web pages on LUGNET: You may freely link to any web page on LUGNET, including other members’ pages, even if you do not first obtain permission. You may also transclude (include copies of) other members’ pages into your own pages using the special FTX page-transclusion feature. When you do this, their name will also appear at the bottom of your page showing that you have included content owned by someone else. A viewer is also able to jump directly to any transcluded page, making it effectively impossible to “steal” content from others without giving them credit.


3. Does LUGNET own the stuff I put up?

Unless you specifically transfer copyright ownership: No, it does not.

When you create personal pages on LUGNET, you retain copyright ownership of the data you input (assuming you own it in the first place). As part of LUGNET’s Terms of Use Agreement, you grant LUGNET, among other things, a non-exclusive license to adapt and publish your content on the World Wide Web. Thus, LUGNET does not own your content but is a publisher of it.

You are free to use or publish your content (specifically, the data you input) elsewhere or license it to others at your own discretion. Note, however, that the license you grant to LUGNET when you input data is perpetual (meaning forever), irrevocable (meaning that you can’t later change your mind and reverse the grant of license), royalty-free (meaning that LUGNET does not pay you for your content), worldwide, and applies to any communications medium.


4. Why won’t HTML code work on my page?

LUGNET Member pages use a special format called FTX rather than HTML.


5. Why use FTX over HTML?

FTX is more streamlined than HTML. A typical block of HTML may contain a mixture of text and many “markup tags” (<TABLE>, <UL>, <BR>, etc.) and “character entities” (&reg; &copy; &quot; &#8482; etc.), while the same block as FTX content would likely show your text with any formatting characters included inline with your copy. That makes FTX more compact and more legible when editing.

It is important that everyone in the LUGNET community feel comfortable about creating their own web pages. Many people have no experience in this field. If methods are kept as simple as possible, it is hoped that everyone will become publishers.


6. Can FTX and HTML do the same things?

It depends on what you want to do. If you expect only to write paragraphs of text, include hyperlinks, create simple tables, and show a few images, then they are much the same.

But FTX wasn’t designed to be as general as HTML. FTX is a fast way to write formatted text or hypertext documents. Pages are quick, clean, and consistent.

FTX cannot do everything that HTML can do. However, it does have a few new tricks of its own. For example, FTX pages may include copies of whole other FTX pages through a special kind of hyperlink which does not exist in HTML.


7. Have you considered offering a restricted subset of HTML for those who are comfortable with HTML?

It may be offered someday. For now though, we wish to give this simpler system a complete test.


8. What about tables? And colors?

Simple two-dimensional tables are possible in FTX (See the User Guide page for more details). Complex layouts or nested tables are not available in FTX code, although a future version of FTX may include stronger table support. We’re also thinking about how to handle colors.


9. Are there any size limits?

Currently, for practical reasons relating to HTML forms, a single page is limited to 65,000 text characters of FTX code. However, you can create larger overall pages using the page transclusion feature, which imposes no limits on the sizes of composite pages.

There is currently no system-enforced limit on the number of FTX pages that you are allowed to create.


10. Can a friend and I work on a page together?

Currently, no. However, it is technically possible. We may enable you to open some of your pages to editing by other LUGNET Members. You would have control over which pages and who you would allow editing access.


11. Can I sell stuff through my pages?

If:
  • It is legal for you to sell it, and
  • It is related to LEGO® toys, and
  • You don’t do anything which goes against LUGNET’s Terms of Use Agreement,
then Yes. Otherwise, No.

However, even if the answer is Yes, you still mustn’t ever spam anyone via email or post messages about your sales to discussion groups excessively. That is, a few messages to discussion groups are OK (so long as the groups permit this in their charters), but an excessive level is not. (You’ll probably find out quickly if you annoy someone.) Sending direct email solicitations to anyone regarding pages you create is also a big “no-no.”


12. I’m an associate seller for Foo.com. Can I build a virtual store on LUGNET?

See previous question and answer. Also bear in mind that LUGNET is an Amazon.com Associate with links to books, LEGO® sets, and other items using the Amazon.com Associate ID lugnet. Thus, if you make links to items for sale using a different associate ID, you may take potential commissions away from LUGNET.

Incidentally, if you would like to help LUGNET, you are more than welcome to make links to products for sale at Amazon.com using LUGNET’s Amazon.com associate ID. For example, if you wanted to include a link to The Ultimate LEGO® Book (ISBN 078944691X), you would make a URL like this one:

      http://www.amazon.com/exec/obidos/ASIN/078944691X/lugnet/


13. Can I display banner ads (like ILE)?

If you can figure out a way to display them, yes, you may. However, LUGNET’s Member pages facility is not intended as general-purpose web hosting. Please keep your pages tasteful, on-topic, and of interest to the online LEGO® enthusiast community.


14. Can I register my pages with a search engine?

You could, although doing so would probably have no effect. Since nearly all webpages on LUGNET are dynamically generated, web crawlers can have a noticable impact on the server, especially when accessing URLs representing alternative views of pages. Thus, LUGNET has a robots.txt file which asks crawlers to steer clear in many cases.

What we’d like (separate from having an integrated search engine for Member pages right on LUGNET) is to find a way to submit specific pages to major search engines and allow them access to these specific pages, while still turning away problematic crawlers. Solving this problem may be easy for some search engines and difficult for others.


15. Do the initials FTX stand for anything?

FTX is short for “formatted text” (or, if you prefer, “fancy text”).

(By the way, HTML is short for “hypertext markup language.”)

All text, images, or trademarks in this document are the intellectual property of their respective owners.


©2005 LUGNET. All rights reserved. - hosted by steinbruch.info GbR