Kirby Help
finding and changing the Title in header.php
title actually resides in a simple .txt file
located in /content/site.txt
The $site object contains all important information about your site in general and all data stored in /content/site.txt
Markdown Syntax
for a full list of Markdown Syntax visit Daring Fireball
all quoted text comes from that website
emphasis:
*bold* thus: bold
_bold_ and: bold
comments: use HTML comment syntax, ie: <!-- comment here -->
"Unordered (bulleted) lists use asterisks, pluses, and hyphens (*, +, and -) as list markers. These three markers are interchangable:"
* Dogs.
* Cats.
* Sandwiches.
thus:
- Dogs.
- Cats.
- Sandwiches.
"Ordered (numbered) lists use regular numbers, followed by periods, as list markers:"
- Red
- Green
- Blue
Output (this goes for unordered lists too):
<ol>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ol>
Links:
"Markdown supports two styles for creating links: inline and reference. With both styles, you use square brackets to delimit the text you want to turn into a link."
"Inline-style links use parentheses immediately after the link text. For example:"
This is an [example link](http://example.com/).
Output:
<p>This is an <a href="http://example.com/">
example link</a>.</p>"
"Optionally, inline-style links may include a title attribute in the parentheses:"
This is an [example link](http://example.com/ "With a Title").
This is an example link - and when you hover your mouse over it, you will see the title.
"Reference-style links allow you to refer to your links by names, which you define elsewhere in your document:"
I get better results using [DuckDuckGo][1] than from [Google][2] or [Yahoo][3].
[1]: https://duckduckgo.com/ "DuckDuckGo"
[2]: https://google.com/ "Google Search"
[3]: https://yahoo.com/ "Yahoo Search"
renders thus:
I get better results using DuckDuckGo than from Google or Yahoo.
Images
placing images is really easy;
simply type the following (without the spaces):
( image: tepid.jpg caption: relevant caption text class: uniquename )
( image: tepid.jpg caption: relevant caption text class: uniquename )
- image: calls up an image
- caption: makes caption text visible
- class: this is the interesting bit; you can give your image a unique name and then style it in
assets/main.css
place the image/s in the same folder as the relevant .txt file.
horizontal rule - four underscores in a row. there are others but this is sufficient.
Code:
To indicate a span of code, wrap it with backtick quotes (`). Unlike a pre-formatted code block, a code span indicates code within a normal paragraph. For example:
Use the printf() function.
will produce:
<p>Use the <code>printf()</code> function.</p>
Automatic Links
Markdown supports a shortcut style for creating “automatic” links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this:
Markdown will turn this into:
<a href="http://example.com/">http://example.com/</a>
Automatic links for email addresses work similarly, except that Markdown will also perform a bit of randomized decimal and hex entity-encoding to help obscure your address from address-harvesting spambots. For example, Markdown will turn this:
into something like this:
<ahref="mailto:addre ss@example.co m">address@exa mple.com</a>
which will render in a browser as a clickable link to “address@example.com”.
(This sort of entity-encoding trick will indeed fool many, if not most, address-harvesting bots, but it definitely won’t fool all of them. It’s better than nothing, but an address published in this way will probably eventually start receiving spam.)