index.xml 6.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  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>Coding on Infusion</title>
  5. <link>https://heydon.github.io/infusion/patterns/coding/</link>
  6. <description>Recent content in Coding on Infusion</description>
  7. <generator>Hugo -- gohugo.io</generator>
  8. <language>en-us</language>
  9. <atom:link href="https://heydon.github.io/infusion/patterns/coding/index.xml" rel="self" type="application/rss+xml" />
  10. <item>
  11. <title>Code blocks</title>
  12. <link>https://heydon.github.io/infusion/patterns/coding/code-blocks/</link>
  13. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  14. <guid>https://heydon.github.io/infusion/patterns/coding/code-blocks/</guid>
  15. <description>Markdown already supports code samples both inline (using single backticks like `some code here`) and in blocks. Infusion will syntax highlight HTML, CSS, and JavaScript if you provide the correct language in the formulation of the block.
  16. So, this&amp;hellip;
  17. ```html &amp;lt;button aria-pressed=&#34;false&#34;toggle me&amp;lt;/button ``` &amp;hellip; will result in this:
  18. &amp;lt;button aria-pressed=&amp;quot;false&amp;quot;&amp;gt;toggle me&amp;lt;/button&amp;gt; Note that the syntax highlighting uses a greyscale theme. Infusion is careful not to use color as part of its own design, because these colors may clash with those of the design being illustrated and discussed.</description>
  19. </item>
  20. <item>
  21. <title>CodePen embedding</title>
  22. <link>https://heydon.github.io/infusion/patterns/coding/codepen-embedding/</link>
  23. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  24. <guid>https://heydon.github.io/infusion/patterns/coding/codepen-embedding/</guid>
  25. <description>Sometimes just pictures of the pattern you&amp;rsquo;re documenting aren&amp;rsquo;t enough. Interactive patterns benefit from live demos, so that readers can test their functionality.
  26. Infusion offers a couple of ways to do this. The first is by embedding CodePen demos into the content. The codePen shortcode takes just one argument: the codePen&amp;rsquo;s ID.
  27. &amp;#x7b;{% codePen VpVNKW %}} This will embed the identified codePen into the content wherever you placed the shortcode, with the result view showing by default:</description>
  28. </item>
  29. <item>
  30. <title>Writing inline demos</title>
  31. <link>https://heydon.github.io/infusion/patterns/coding/writing-inline-demos/</link>
  32. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  33. <guid>https://heydon.github.io/infusion/patterns/coding/writing-inline-demos/</guid>
  34. <description>There are some issues with CodePen embedding, like them not working offline. They also come with CodePen branding, which will clash with the pattern you&amp;rsquo;re trying to illustrate.
  35. Infusion offers another option: a special demo shortcode that allows you to write HTML, CSS, and JavaScript directly into the markdown file. The outputted demo is encapsulated using Shadow DOM, so you don&amp;rsquo;t have to worry about broken styles and global JS.</description>
  36. </item>
  37. <item>
  38. <title>Color palettes</title>
  39. <link>https://heydon.github.io/infusion/patterns/coding/color-palettes/</link>
  40. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  41. <guid>https://heydon.github.io/infusion/patterns/coding/color-palettes/</guid>
  42. <description>There&amp;rsquo;s no reason why your Infusion-powered pattern library has to be all about functionality. You can include style guide-like information such as color palettes too. The colors shortcode makes it easy to exhibit colors and their values together. Just supply a comma-separated list of CSS color values.
  43. &amp;#x7b;{% colors &#34;#111111, #cccccc, #ffffff&#34; %}} The result is a one row strip showing each color supplied in order. The colors for Infusion are greyscale:</description>
  44. </item>
  45. <item>
  46. <title>Command line</title>
  47. <link>https://heydon.github.io/infusion/patterns/coding/command-line/</link>
  48. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  49. <guid>https://heydon.github.io/infusion/patterns/coding/command-line/</guid>
  50. <description>Your pattern documentation may need to include commands for installing packages or using CLIs. Infusion offers the cmd shortcode for making code blocks look like terminal commands.
  51. Here&amp;rsquo;s how you write it:
  52. &amp;#x7b;{&amp;lt;cmd}} npm run start &amp;#x7b;{&amp;lt;/cmd}} And here&amp;rsquo;s how it looks:
  53. npm run start The cmd shortcode currently only supports single commands. If you want to show multiple, successive commands use separate cmd blocks.
  54. </description>
  55. </item>
  56. <item>
  57. <title>File trees</title>
  58. <link>https://heydon.github.io/infusion/patterns/coding/file-trees/</link>
  59. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  60. <guid>https://heydon.github.io/infusion/patterns/coding/file-trees/</guid>
  61. <description>Representing folder/file structures is simple and accessible in Infusion. Which is just as well, because some components may need to conform to a certain folder structure.
  62. The file tree is described using a markdown nested list structure:
  63. &amp;#x7b;{% fileTree %}} * Level 1 folder * Level 2 file * Level 2 folder * Level 3 file * Level 3 folder * Level 4 file * Level 3 folder * Level 4 file * Level 4 file * Level 2 folder * Level 3 file * Level 3 file * Level 3 file &amp;#x7b;{% /fileTree %}} This is drawn in the following fashion, but preserves the underlying nested list structure for assistive technologies such as screen readers:</description>
  64. </item>
  65. <item>
  66. <title>Tested using...</title>
  67. <link>https://heydon.github.io/infusion/patterns/coding/tested/</link>
  68. <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
  69. <guid>https://heydon.github.io/infusion/patterns/coding/tested/</guid>
  70. <description>When you&amp;rsquo;re an inclusive designer, it&amp;rsquo;s pertinent to do some testing. Following specs is one thing, but you need to verify that your component works okay for users.
  71. Infusion provided a tested shortcode that let&amp;rsquo;s you show which browsers and assistive technologies you&amp;rsquo;ve tried your design out in. Here&amp;rsquo;s an example. Note the commas and &amp;ldquo;+&amp;rdquo; signs.
  72. &amp;#x7b;{% tested using=&#34;Firefox Android + NVDA, Chrome, Safari iOS + Voiceover, Edge&#34; %}} This outputs:</description>
  73. </item>
  74. </channel>
  75. </rss>