Laelith Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Editing the Wiki page of your Property ======

When you become the happy owner of a Property (sometimes called a "Lot"), it is your job to write about it: giving it a nice name, describing it, adding images, etc.

This is accomplished by writing in the Wiki page that was automatically assigned to your Property. The Laelith interactive map will grab it, extract its text, images and metadata, and display all these elements in a nice way.

We won't go into the details of editing a Wiki page here, this topic is fully covered in [[https://www.dokuwiki.org/start?id=wiki:syntax|the DokuWiki documentation]]. We'll focus instead on how the relationship works between your content and what shows up in the Map (or on your Profile).

===== Getting started: your Profile =====

You will see your Property in your character's page. You can find your character page by going to your account settings at https://www.laelith.com/settings and clicking on your character's avatar. You will see the properties at the bottom of the page :

{{ :en:help:editing-property:lot_editing1.png?nolink&500 }}

  * Clicking on the image will take you to the map and zoom on it, using its Cadastre ID (the identifier that looks like 1.2.3.4).
  * Clicking on the little book icon will take you to the Wiki page

===== Creating the Wiki page =====

**Click on the little book icon**: this will take you to the Laelith Wiki at the url prepared for your Property. So you may wonder why it's telling you that the page does not exist yet?

{{ :en:help:editing-property:lot_editing2.png?nolink&500 }}

You must create the page yourself. Simply click on the pen button on the right side and confirm "**Create this page**":

{{ :en:help:editing-property:lot_editing3.png?nolink |}}


Hurray, you can now type your text, preview it and save the page!

===== Naming your Property =====

Give a title to your page using the H1 headline. The Map will use it to name your Property.

  ====== Harzak's Little House ======

===== Writing the summary paragraph =====

Go ahead and type a first paragraph of text. The Map will extract it from the page and display it first. Following paragraphs will be added to the "Learning More" section on the Map panel.

  This little house on the Lakeshoe Terrace seems poor and quiet,
  but don't be fooled! It is in fact the hideout place of Harzak the
  Thief - a man of sinister reputation...

===== Seeing your changes on the Map =====

Your changes will be applied immediately, but you still need to reload the page in your Web browser to see them.

===== Adding Images =====

It's a detail, but make sure you save your page at least once before following the procedure below: this will prepare the upload area properly for you.

When you are editing your Wiki page, place the text cursor where you want to place an image an push the Insert Picture button:
{{ :en:help:editing-property:lot_editing4.png?nolink&50 |}}

This opens the Media Manager in a separate window, and by default set it to a folder named by the cadastre id of your property:

{{ :en:help:editing-property:lot_editing6.png?nolink&500 |}}

Now you can add an image from your disk using the "Select files" button. Don't forget to push the "Upload" button after that! The image will appear below. Click on it to insert it in the page, and a small dialog will appear with all kinds of layout options:
{{ :en:help:editing-property:lot_editing7.png?nolink&300 |}}

This allows you to control if you want to open the image in a new window, or add a link to it, how to align it with the text, how big it should be, etc. Experiment with the various options and push the Insert button. Congratulations, your code is inserted in the Wiki page (here, centered, with the no link option):

  {{ :en:lakeshoe:1234:general_view.jpg?nolink }}

Here is one last trick: if you want your image to have a title in the Map, add a comment to it like this using a vertical dash **''|''**:

  {{ :en:lakeshoe:1234:general_view.jpg?nolink |General View}}

You can add more images in your page. The first image will be used at the main image of your Property, and the other images will appear in the "**Photos**" section of the Map panel.

===== Entering Metadata =====

Now, let's talk about Metadata.

You can insert special hidden values in your Wiki page that will be displayed on the Map. For example, if you want to indicate the address, add this to the page:

  <!--
  @address: Smugglers Wharf
  -->

Reload the Map page, and voilà! 

Metadata variables are flexible, and can add details to your Property description on the Map. Here are some more:
  * ''@short_ref'': to indicate a reference. For example, a book and page number, an author, etc. It will appear after the first text in the Map panel.
  * ''@long_ref'': same thing, for the "learning more" paragraphs of text
  * ''@image_credit'': to show some copyright information under the first image
  * ''@photos_credit'': same thing, but for all other images
  * ''@business'': you can indicate the business activity there (Taberge,...)
  * ''@url'': can be used to insert a link next to your name. For example to direct people to a personal page, your corporate website, or your collection of fantasy figs


Enjoy!