Laelith Wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== 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 Profile at https://id.laelith.com/profile :

* Clicking on the image will take you to the map and zoom on it, using its Cadastre ID (the identifier that looks like 1234).
  * 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?

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

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 in the Namespace of the parent page instead of the one of the current page (which is not very convenient - we will have to see how it can be improved):
{{ :en:help:editing-property:lot_editing5.png?nolink&500 |}}

So you need to click on your page name on the left list, or you won't be able to add images. Usually, it is your Property ID (here: "1234"): 
{{ :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):

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 **''|''**:

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:

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!

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International