Strolen\s Citadel content. 
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-09-28 08:47 PM
Scrolls

Scrolls are collections of minor posts. If you have seen a few, there is little to explain. The most typical uses of them are:

- Collections of whatever similar pieces you want. Say you want to create Magical Cigars, Islands or, heck, Torture Devices and Techniques if that is what you are into. You may post a few, and call for others to post their own ideas. If successful, these scrolls can become very popular and gather over a hundred posts to them! You were warned. :D

- A single submission broken into several parts, sometimes of a very different nature. This is usually done with submissions that are too long or too complicated, to prevent the reader's head from blowing up. Here you can fit your world's history, or that large system post that is still worked on in some parts. There are several BIG plots with tons of notes and details, where each important part of the plot gets one scroll post. There can be also encounter tables, write-ups of the events and NPCs, and much more.

Note: You can create an index in the body of a submission to point to the important scroll comments.


Linking in Scrolls

Linking to scroll comments is pretty much the same as linking to ordinary comments.

Especially in complicated plots, you can have fun with linking between the scrolls. (So, the noble NPC is active in Act I. and Act III., so both will link to it. He is interested in the dingus, so he will be linked to it as well. Another NPC hates the noble, and will act against him... and so on, and so on.)

Warning: setting up all the links takes time, splitting the post into meaningful batches and writing up all the references even more. If you succeed, you will get a beautiful document you can merrily click around on, with all the information at your fingertips; hypertext at its finest. If you fail, you will get a jumbled mess of confusing links and shreds of information which will take a while to read and understand. I have accomplished both, so I know what I am speaking about. ;) Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-09-28 08:51 PM
Codices

A Codex is a collection of submissions, that were Suggested as noted above. Again, look at a few to see what it is about. In a Codex, you not only want to see that other submissions are linked to it (with their titles and summaries), you want to see them in all beauty. Handily, the Codex indexes all subs that are linked to it.


It appears there are two basic uses for Codices:

- "Public" collections, where submissions are put together based on something they have in common - the Bizzare Life-Forms Challenge has strange lifeforms, The 30 has groups of similar NPCs, Remaking the Undead groups undead creatures of remarkable scariness.

- "Private" collections, where the author gathers a few submissions that need to be displayed in entirety. These are often related to one setting, but can be plots and the like as well (the 5in1 challenge was notorious).

Note: Codices are pretty when there are a few submissions linked to them, but the truly big ones can become too heavy. There is some discussion of how to make them easier to handle, Citadel v3.0 should bring a new Codex interface.


Linking inside of a Codex:

To link to a submission, that is in its entirety on the Codex page, just a little peek at that index is needed: a 't' has to be added at the end of the Link. So it looks like:

left square bracket + Link + right square bracket

OR use a pipe '|' and add a title you like:

left square bracket + Link + pipe + Title + right square bracket


Where Link is:

CodexSubmissionID + hash + LinkedSubmissionID + t

(It is suggested that both IDs be numerical; the second has to be.) Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-09-28 08:52 PM
The Freetext

The freetext is a strange but lovely animal. Take a look at the word cloud ( http://www.strolen.com/view.php?node=freetext&free=Freetext ). A freetext groups submissions, though in a looser way. It is used to mark all subs of a certain setting (Arth, Hewdamia, Neyathis), note that the submission has a particular format ('30', '101', 'Tales of Adventure'), or that it has a particular content ('Schools of Magic'). It is useless, if it has only one sub. But tag several submissions with it, and order starts to emerge!

A freetext should be short, and as clear as possible (see an entire discussion on how it should be employed http://www.strolen.com/guild/index.php/topic,3824.0.html ).

A submission can have several freetexts (let's say "Fungus", "Setting Name", and "Poison"), and all link it to other submissions with the same characteristic. These tags are displayed on the upper right of a submission.


How to add freetexts? Simply: write the freetext(s) into their field when submitting or updating the sub. If there are more, separate them with a comma. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-10-05 08:09 PM
Images

Okay, this is not exactly a way to connect submissions together, but it makes them prettier! The gallery is a moody piece of softare, and the syntax is a little bit complicated, but let's take a look:

left square bracket + left square bracket + Image Size + pipe + Image Name + pipe + Alignement + pipe + Alternative Text + right square bracket + right square bracket

Yes, there are two sets of brackets, and several parameters separated by pipes ('|').


So what do all those parameters do?

Image Size - can be 'normal', or 'thumb', for displaying the whole picture or just a thumbnail.

Image Name - the exact name of the image file you have uploaded into your gallery (something.jpg for example).

Alignment - may be 'left', 'middle', or 'right'. 'left' and 'right' will wrap text around the image, 'middle' will leave it alone.

Alternative Text - the text, that will be displayed if no image is loaded (or if you hold your mouse over it for a while).

h1-10000.jpg|left|Elder Citadel Dragon] An example, taken from one of the older incarnations of the Citadel. It is a thumbnail aligned to the left, and the text can flow nicely around it. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-10-27 05:30 PM
External Links (IN PROGRESS)

Links to external resources (well, to anything other than what was already mentioned), are your basic HTML links.

Example - link to all freetexts: http://strolen.com/freetext


A simple html link would look like this: (or just refer to any official documentation to HTML)

opening bracket + 'a href=' + quote + Full Link + quote + closing bracket + Title + opening bracket + /a + closing bracket
(All brackets here are angular brackets.) Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-10-28 01:12 PM
(Say, isn't that the other way around - "Codex ID + pipe + Back to Top"?)

It is a good idea, though. If you want to, you can post it as a reply to the part about Codices. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2007-10-29 01:22 PM
Well, you can always update it if you want to - improving the submissions is not frowned upon, but actually quite welcome!

(Thanks for the compliments as well!) Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2009-03-11 05:48 PM
Since there are some considerations about documenting the intricate workings of the Citadel, it's time to Bump this lady! Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
manfred's comment on 2011-05-19 03:49 AM
It could really use an update though. :) Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
MoonHunter's comment on 2007-10-30 03:19 PM
One should always give intense love to site specific reference submissions. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Scrasamax's comment on 2007-10-27 11:42 PM
An excellent resource, one that can be used by our new members, and some of our more established members who have linking problems. I would like to add a trick I've used in one of my codices that became cumbersomely large. After writing a large amendment to the codex, I would end it with a link that returned the viewer back to the top of the page.

The way I did this was as follows:

left square bracket + Back to Top + pipe + Codex ID + right square bracket

Essentially I linked the end of each codex section back to the codex itself, so clicking on the link reloaded the page and started the viewer back at the top of the page. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Cheka Man's comment on 2007-10-27 11:16 PM
Only voted Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Michael Jotne Slayer's comment on 2007-11-30 02:59 PM
Nicely wrapped up tutorial. It can serve as a reminder when we need it as well as giving great advice for beginners. Good work Manfred! Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Dozus's comment on 2007-10-29 12:19 PM
Informative! Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Murometz's comment on 2007-10-27 05:20 PM
Very good. A primer, a refresher, and a much-needed tutorial. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Murometz's comment on 2009-12-18 11:13 AM
An invaluable Citadel resourse for all to read! :) Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
valadaar's comment on 2007-10-29 12:04 PM
As said, an excellent utility sub. Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Ouroboros's comment on 2007-10-29 12:41 PM
Excellent! A pretty, professional layout is what gives a good submission the final buff! Just wish I´d read through this on before I posted...Oh well Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
Moonlake's comment on 2009-03-11 08:20 PM
Extremely useful! Go to Comment
The Art of Linking
Articles  (Rules and Advice)   (Citadel Help)
tinypoisonousfish's comment on 2009-12-19 09:04 AM
Useful, thanks. Go to Comment
Total Comments:
3180

Join Now!!




Fatal error: Call to undefined function top_menu() in /home/strolen/public_html/lockmor/application/views/citadel/vfooter.php on line 2