index.xml 4.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. <?xml version="1.0" encoding="utf-8" standalone="yes" ?>
  2. <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  3. <channel>
  4. <title>Writing on Infusion</title>
  5. <link>/patterns/writing/</link>
  6. <description>Recent content in Writing on Infusion</description>
  7. <generator>Hugo -- gohugo.io</generator>
  8. <language>en-us</language>
  9. <atom:link href="/patterns/writing/index.xml" rel="self" type="application/rss+xml" />
  10. <item>
  11. <title>Library structure</title>
  12. <link>/patterns/writing/library-structure/</link>
  13. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  14. <guid>/patterns/writing/library-structure/</guid>
  15. <description>Before you can set about documenting patterns, you need to know where everything goes. The simplest folder structure looks like this:
  16. └── 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&amp;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>
  17. </item>
  18. <item>
  19. <title>Markdown &amp; metadata</title>
  20. <link>/patterns/writing/markdown-and-metadata/</link>
  21. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  22. <guid>/patterns/writing/markdown-and-metadata/</guid>
  23. <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&amp;rsquo;s recommended you use &amp;ldquo;kebab case&amp;rdquo; to name the file ( words separated by hyphens). For example, a pattern with the title &amp;ldquo;Menu button&amp;rdquo; should probably have the filename menu-button. Then you get a nice clean URL: your-company.com/patterns/menu-button.
  24. If you&amp;rsquo;re not familiar with writing markdown, there are a number of tutorials available.</description>
  25. </item>
  26. <item>
  27. <title>Including images</title>
  28. <link>/patterns/writing/including-images/</link>
  29. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  30. <guid>/patterns/writing/including-images/</guid>
  31. <description>From time to time, you&amp;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&amp;rsquo;ll be mostly working in.
  32. ├── content └── static └── images ├── logo.png └── menu-button.gif When you first make a copy of Infusion, Infusion&amp;rsquo;s own logo will be included. You should replace this with your own company or project logo.</description>
  33. </item>
  34. <item>
  35. <title>Notes &amp; warnings</title>
  36. <link>/patterns/writing/notes-and-warnings/</link>
  37. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  38. <guid>/patterns/writing/notes-and-warnings/</guid>
  39. <description>Infusion acknowledges that simple markdown is limiting when it comes to writing compelling documentation, so it provides a number of &amp;ldquo;shortcodes&amp;rdquo;. Shortcodes offer a simple syntax for including rich content. For example, Infusion provides shortcodes for including notes and warnings.
  40. Notes You may wish to pick out some content in your pattern&amp;rsquo;s documentation as a note — an aside to the main thrust of the pattern&amp;rsquo;s description. This is possible using the following syntax:</description>
  41. </item>
  42. <item>
  43. <title>References</title>
  44. <link>/patterns/writing/references/</link>
  45. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  46. <guid>/patterns/writing/references/</guid>
  47. <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&amp;rsquo;s what the markdown looks like, including the shortcode:
  48. I can reference the &amp;#x7b;{% pattern &#34;Notes and warnings&#34; %}} 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>
  49. </item>
  50. </channel>
  51. </rss>