User Tools

Site Tools


software:picocms_welcome

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
software:picocms_welcome [2025/06/05 16:59] – [```] timbsoftware:picocms_welcome [2025/06/05 17:03] (current) timb
Line 3: Line 3:
 See also: [[software:pico_cms]] See also: [[software:pico_cms]]
  
-Contents +Contents of the document.  Note, I had to replace all the references to `</code>` with `</ code>` so Dokuwiki wouldn't interpret it.
  
 <code> <code>
-```+
 --- ---
-Title: Welcom +Title: Welcome 
-e+
 Description: Pico is a stupidly simple, blazing fast, flat file CMS. Description: Pico is a stupidly simple, blazing fast, flat file CMS.
 --- ---
Line 98: Line 98:
 by default. If you want to use some assets (e.g. a image) in one of your content by default. If you want to use some assets (e.g. a image) in one of your content
 files, use Pico's `assets` folder. You can then access them in your Markdown files, use Pico's `assets` folder. You can then access them in your Markdown
-using the <code>&#37;assets_url&#37;</code> placeholder, for example: +using the <\code>&#37;assets_url&#37;</ code> placeholder, for example: 
-<code>!\[Image Title\](&#37;assets_url&#37;/image.png)</code>+<code>!\[Image Title\](&#37;assets_url&#37;/image.png)<code>
  
 ### Text File Markup ### Text File Markup
Line 132: Line 132:
 `img.small { width: 80%; }`). You can then use these CSS classes in your `img.small { width: 80%; }`). You can then use these CSS classes in your
 Markdown files, for example: Markdown files, for example:
-<code>!\[Image Title\](&#37;assets_url&#37;/image.png) {.small}</code>+<code>!\[Image Title\](&#37;assets_url&#37;/image.png) {.small}</ code>
  
 There are also certain variables that you can use in your text files: There are also certain variables that you can use in your text files:
  
-* <code>&#37;site_title&#37;</code> - The title of your Pico site +* <code>&#37;site_title&#37;</ code> - The title of your Pico site 
-* <code>&#37;base_url&#37;</code> - The URL to your Pico site; internal links +* <code>&#37;base_url&#37;</ code> - The URL to your Pico site; internal links 
-  can be specified using <code>&#37;base_url&#37;?sub/page</code> +  can be specified using <code>&#37;base_url&#37;?sub/page</ code> 
-* <code>&#37;theme_url&#37;</code> - The URL to the currently used theme +* <code>&#37;theme_url&#37;</ code> - The URL to the currently used theme 
-* <code>&#37;assets_url&#37;</code> - The URL to Pico's `assets` directory +* <code>&#37;assets_url&#37;</ code> - The URL to Pico's `assets` directory 
-* <code>&#37;themes_url&#37;</code> - The URL to Pico's `themes` directory; +* <code>&#37;themes_url&#37;</ code> - The URL to Pico's `themes` directory; 
-  don't confuse this with <code>&#37;theme_url&#37;</code> +  don't confuse this with <code>&#37;theme_url&#37;</ code> 
-* <code>&#37;plugins_url&#37;</code> - The URL to Pico's `plugins` directory +* <code>&#37;plugins_url&#37;</ code> - The URL to Pico's `plugins` directory 
-* <code>&#37;version&#37;</code> - Pico's current version string (e.g. `2.0.0`) +* <code>&#37;version&#37;</ code> - Pico's current version string (e.g. `2.0.0`) 
-* <code>&#37;meta.&#42;&#37;</code> - Access any meta variable of the current +* <code>&#37;meta.&#42;&#37;</ code> - Access any meta variable of the current 
-  page, e.g. <code>&#37;meta.author&#37;</code> is replaced with `Joe Bloggs` +  page, e.g. <code>&#37;meta.author&#37;</ code> is replaced with `Joe Bloggs` 
-* <code>&#37;config.&#42;&#37;</code> - Access any scalar config variable, +* <code>&#37;config.&#42;&#37;</ code> - Access any scalar config variable, 
-  e.g. <code>&#37;config.theme&#37;</code> is replaced with `default`+  e.g. <code>&#37;config.theme&#37;</ code> is replaced with `default`
  
 ### Blogging ### Blogging
Line 259: Line 259:
 seeing `My <strong>favorite</strong> color` - yes, including the markup! To seeing `My <strong>favorite</strong> color` - yes, including the markup! To
 actually get it parsed, you must use `{{ meta.headline|raw }}` (resulting in actually get it parsed, you must use `{{ meta.headline|raw }}` (resulting in
-the expected <code>My **favorite** color</code>). Notable exceptions to this+the expected <code>My **favorite** color</ code>). Notable exceptions to this
 are Pico's `content` variable (e.g. `{{ content }}`), Pico's `content` filter are Pico's `content` variable (e.g. `{{ content }}`), Pico's `content` filter
 (e.g. `{{ "sub/page"|content }}`), and Pico's `markdown` filter, they all are (e.g. `{{ "sub/page"|content }}`), and Pico's `markdown` filter, they all are
Line 336: Line 336:
 * Pass the unique ID of a page to the `link` filter to return the page's URL * Pass the unique ID of a page to the `link` filter to return the page's URL
   (e.g. `{{ "sub/page"|link }}` gets `%base_url%?sub/page`).   (e.g. `{{ "sub/page"|link }}` gets `%base_url%?sub/page`).
-* You can replace URL placeholders (like <code>&#37;base_url&#37;</code>) in+* You can replace URL placeholders (like <code>&#37;base_url&#37;</ code>) in
   arbitrary strings using the `url` filter. This is helpful together with meta   arbitrary strings using the `url` filter. This is helpful together with meta
-  variables, e.g. if you add <code>image: &#37;assets_url&#37;/stock.jpg</code>+  variables, e.g. if you add <code>image: &#37;assets_url&#37;/stock.jpg</ code>
   to the YAML header of a page, `{{ meta.image|url }}` will return   to the YAML header of a page, `{{ meta.image|url }}` will return
   `%assets_url%/stock.jpg`.   `%assets_url%/stock.jpg`.
Line 346: Line 346:
   you might use Markdown in the `description` meta variable and later parse it   you might use Markdown in the `description` meta variable and later parse it
   in your theme using `{{ meta.description|markdown }}`. You can also pass meta   in your theme using `{{ meta.description|markdown }}`. You can also pass meta
-  data as parameter to replace <code>&#37;meta.&#42;&#37;</code> placeholders+  data as parameter to replace <code>&#37;meta.&#42;&#37;</ code> placeholders
   (e.g. `{{ "Written by *%meta.author%*"|markdown(meta) }}` yields "Written by   (e.g. `{{ "Written by *%meta.author%*"|markdown(meta) }}` yields "Written by
   *John Doe*"). However, please note that all contents will be wrapped inside   *John Doe*"). However, please note that all contents will be wrapped inside
Line 445: Line 445:
 [OfficialThemes]: http://picocms.org/themes/ [OfficialThemes]: http://picocms.org/themes/
 [PluginUpgrade]: http://picocms.org/development/#upgrade [PluginUpgrade]: http://picocms.org/development/#upgrade
-```+ 
 +</code> 
software/picocms_welcome.1749142773.txt.gz · Last modified: by timb