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.)