1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798 |
- <?xml version="1.0" encoding="utf-8" standalone="yes" ?>
- <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
- <channel>
- <title>The Infusion Pattern Library Builder on Infusion</title>
- <link>/</link>
- <description>Recent content in The Infusion Pattern Library Builder on Infusion</description>
- <generator>Hugo -- gohugo.io</generator>
- <language>en-us</language>
- <lastBuildDate>Mon, 26 Jun 2017 18:27:58 +0100</lastBuildDate>
-
- <atom:link href="/index.xml" rel="self" type="application/rss+xml" />
-
-
- <item>
- <title>Library structure</title>
- <link>/patterns/writing/library-structure/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/writing/library-structure/</guid>
- <description>Before you can set about documenting patterns, you need to know where everything goes. The simplest folder structure looks like this:
- └── content ├── _index.md └── patterns ├── name-of-my-pattern.md └── name-of-my-other-pattern.md /content - This is where all of your content lives. You won&rsquo;t need to visit any other folders very frequently. _index.md — This is the content for your home page. /patterns — This is the folder where individual pattern files are kept.</description>
- </item>
-
- <item>
- <title>Markdown & metadata</title>
- <link>/patterns/writing/markdown-and-metadata/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/writing/markdown-and-metadata/</guid>
- <description>In Infusion, design patterns are documented using markdown. To create a new pattern file, just add a file with the .md extension to the /patterns folder. It&rsquo;s recommended you use &ldquo;kebab case&rdquo; to name the file ( words separated by hyphens). For example, a pattern with the title &ldquo;Menu button&rdquo; should probably have the filename menu-button. Then you get a nice clean URL: your-company.com/patterns/menu-button.
- If you&rsquo;re not familiar with writing markdown, there are a number of tutorials available.</description>
- </item>
-
- <item>
- <title>Including images</title>
- <link>/patterns/writing/including-images/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/writing/including-images/</guid>
- <description>From time to time, you&rsquo;ll be wanting to include images illustrating the documented pattern in hand. Images live in the static folder, which is a sibling of the /content folder you&rsquo;ll be mostly working in.
- ├── content └── static └── images ├── logo.png └── menu-button.gif When you first make a copy of Infusion, Infusion&rsquo;s own logo will be included. You should replace this with your own company or project logo.</description>
- </item>
-
- <item>
- <title>Installation</title>
- <link>/patterns/installation/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/installation/</guid>
- <description>Infusion is built using the static site engine, Hugo, and NPM. The codebase is available to download on Github. Let&rsquo;s get set up step-by-step.
- 1. Install Hugo First we need to install Hugo globally.
- OSX users If you are a Mac user and have Homebrew on your system, installing Hugo is simple:
- brew install hugo Alternatively, you can manually install Hugo from a package. You can verify the installation was successful by typing:</description>
- </item>
-
- <item>
- <title>Library setup</title>
- <link>/patterns/project-setup/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/project-setup/</guid>
- <description>By now, you should have followed the Installation instructions. You should have Hugo and Node installed, and a local copy of a forked version of Infusion. You should also have run npm install in the root of that codebase.
- &ldquo;Cleaning&rdquo; the content folder Before you can start documenting patterns, there are a few things still to do in order to get set up. At the moment, your version of Infusion is a facsimile of the original, containing all this documentation content.</description>
- </item>
-
- <item>
- <title>Notes & warnings</title>
- <link>/patterns/writing/notes-and-warnings/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/writing/notes-and-warnings/</guid>
- <description>Infusion acknowledges that simple markdown is limiting when it comes to writing compelling documentation, so it provides a number of &ldquo;shortcodes&rdquo;. Shortcodes offer a simple syntax for including rich content. For example, Infusion provides shortcodes for including notes and warnings.
- Notes You may wish to pick out some content in your pattern&rsquo;s documentation as a note — an aside to the main thrust of the pattern&rsquo;s description. This is possible using the following syntax:</description>
- </item>
-
- <item>
- <title>References</title>
- <link>/patterns/writing/references/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/writing/references/</guid>
- <description>Cross-references Infusion provides an easy mechanism to cross-reference patterns, by name, using the pattern shortcode. For example, I can reference the pattern here. Here&rsquo;s what the markdown looks like, including the shortcode:
- I can reference the &#x7b;{% pattern "Notes and warnings" %}} pattern here. This saves you having to worry about pathing and decorates the generated link with a bookmark icon, identifying the link as a pattern reference visually.</description>
- </item>
-
- <item>
- <title>Serving</title>
- <link>/patterns/serving/</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/patterns/serving/</guid>
- <description>Serving locally While you&rsquo;re creating content for your library, you&rsquo;ll probably want to see what the finished product looks like. Fortunately, Infusion is easy to serve locally using the serve command:
- npm run serve This will serve your working library on localhost:1313. Whenever you make changes to your library&rsquo;s files, the site will automatically rebuild. No need to refresh the web page!
- Publishing on Github Pages The easiest way to host your pattern library so you have a link to share is to run the host command.</description>
- </item>
-
- </channel>
- </rss>
|