|
| 1 | +// ARDUINO PYGMENTS HIGHLIGHT ATTRIBUTE ►►►►► ALWAYS INCLUDE IN YOUR FILE ◄◄◄◄◄ |
| 2 | +:source-highlighter: pygments |
| 3 | +:pygments-style: arduino |
| 4 | + |
| 5 | +// This is a documentation file for authors and editors of the Arduino Manutius content platform. |
| 6 | +// Below you can find a list of all the possible page elements with the corresponding |
| 7 | +// AsciiDoc syntax |
| 8 | + |
| 9 | + |
| 10 | +// GENERAL GUIDELINES |
| 11 | +// The [space]+ sends text to a new line, aka it generates a <br> in the HTML output, e.g.: |
| 12 | +// This is some text. + |
| 13 | +// This is some other text in a new line |
| 14 | + |
| 15 | +// The [%hardbreaks] generates a new <p> paragraph, e.g.: |
| 16 | +// This is a <p> paragraph |
| 17 | +// [%hardbreaks] |
| 18 | +// This is another <p> paragraph |
| 19 | + |
| 20 | +// If you need to add a blank line between sections of the page you can use: |
| 21 | +// {empty} + |
| 22 | + |
| 23 | +// Using [%hardbreaks] at the end of a chunk is always a good practice. |
| 24 | +// [%hardbreaks] close the HTML tags, making the HTML output clean. |
| 25 | + |
| 26 | +// This ''' is a line divider |
| 27 | + |
| 28 | + |
| 29 | +// PAGE TITLE |
| 30 | += Page Title [h1] |
| 31 | + |
| 32 | +// SECTION DIV WITH ID STARTS |
| 33 | +[#name_of_id] |
| 34 | +-- |
| 35 | + |
| 36 | +// Add your content here. |
| 37 | + |
| 38 | +// In case your output is an HTML file, this tag will create a wrapper div with the id specified, e.g.: |
| 39 | +// <div id="name_of_id" class="openblock"></div> |
| 40 | + |
| 41 | +-- |
| 42 | +// SECTION DIV WITH ID ENDS |
| 43 | + |
| 44 | + |
| 45 | +// OTHER TITLES |
| 46 | +[float] |
| 47 | +== Section Title [h2] |
| 48 | + |
| 49 | +[float] |
| 50 | +=== Paragraph Title [h3] |
| 51 | + |
| 52 | +[float] |
| 53 | +==== Sub-paragraph Title [h4] |
| 54 | + |
| 55 | + |
| 56 | +''' |
| 57 | + |
| 58 | +// TEXT STYLES |
| 59 | +This is normal <p> text + |
| 60 | +*This is bold <strong> text* + |
| 61 | +_This is italic <em> text_ + |
| 62 | +*_This is bold+italic <strong><em> text_* + |
| 63 | +[small]#This is small <span class="small"> text# + |
| 64 | +#This is highlighted <mark> text# + |
| 65 | +'`This is single quoted text`' + |
| 66 | +"`This is double quoted text`" |
| 67 | +[%hardbreaks] |
| 68 | + |
| 69 | +''' |
| 70 | + |
| 71 | +// LINKS |
| 72 | +// Please note that all external links need to be opened in a new window/tab by adding ^ right before the last square brackets |
| 73 | +http://arduino.cc[This is an external <a href> link^] in a new tab + |
| 74 | +link:../index.html[This is a relative <a href> link] + |
| 75 | +mailto: [email protected][This is an e-mail link] |
| 76 | +[%hardbreaks] |
| 77 | + |
| 78 | +''' |
| 79 | + |
| 80 | +// LISTS |
| 81 | +* This |
| 82 | +* is |
| 83 | +** an |
| 84 | +*** unordered |
| 85 | +* list |
| 86 | + |
| 87 | +[%hardbreaks] |
| 88 | + |
| 89 | +. This |
| 90 | +. is |
| 91 | +.. a |
| 92 | +.. n |
| 93 | +... orde |
| 94 | +... red |
| 95 | +. list |
| 96 | + |
| 97 | +''' |
| 98 | + |
| 99 | +// CODE |
| 100 | +This is `code` in a sentence + |
| 101 | +`This is a whole line of code` + |
| 102 | + |
| 103 | +// HINT: Please note that sometimes when copy-pasting code a few spaces can be added at the beginnng of each line of code. |
| 104 | +// If that happens, please remove the extra spaces. Thanks! |
| 105 | + |
| 106 | +This can be a lot more code |
| 107 | +[source,arduino] |
| 108 | +---- |
| 109 | +for (int 1; i<=99; i++) { |
| 110 | + Serial.println('We want more code!'); |
| 111 | +} |
| 112 | +---- |
| 113 | +[%hardbreaks] |
| 114 | + |
| 115 | +''' |
| 116 | + |
| 117 | +// TABLES |
| 118 | +|=== |
| 119 | +|Name of Column 1 |Name of Column 2 |Name of Column 3 |
| 120 | + |
| 121 | +|Cell in column 1, row 1 |
| 122 | +|Cell in column 2, row 1 |
| 123 | +|Cell in column 3, row 1 |
| 124 | + |
| 125 | +|Cell in column 1, row 2 |
| 126 | +|Cell in column 2, row 2 |
| 127 | +|Cell in column 3, row 2 |
| 128 | + |
| 129 | +|Cell in column 1, row 3 |
| 130 | +|Cell in column 2, row 3 |
| 131 | +|Cell in column 3, row 3 |
| 132 | +|=== |
| 133 | +[%hardbreaks] |
| 134 | + |
| 135 | +''' |
| 136 | + |
| 137 | +// IMAGES |
| 138 | + |
| 139 | +// If you need to add an image to the Asciidoc please create a folder called 'attachments' in the same directory as the Asciidoc file, |
| 140 | +// place the image there and reference it as shown below. Images can be in SVG and PNG format, max size 200KB. |
| 141 | + |
| 142 | +// To include an image on its own line (i.e., a block image), use the image:: prefix in front of the file name and square brackets after it [] |
| 143 | +// Make sure you add [%hardbreaks] between any text and the image |
| 144 | + |
| 145 | +This is a block image with a URL |
| 146 | +[%hardbreaks] |
| 147 | +image::http://store.arduino.cc/bmz_cache/b/babe9d3f8563ea2f170dd55539f06310.image.538x354.jpg[] |
| 148 | + |
| 149 | + |
| 150 | +This is an image saved in the attachments folder with a caption |
| 151 | +[%hardbreaks] |
| 152 | +image::attachments/ArduinoUno_R3_Front_450px.jpg[caption="", title="A beautiful Arduino UNO"] |
| 153 | + |
| 154 | + |
| 155 | +''' |
| 156 | + |
| 157 | +// EMBED |
| 158 | + |
| 159 | +This is a pretty embed of code from Gist |
| 160 | +++++ |
| 161 | +<script src="http://gist.github.com/mojavelinux/5333524.js"> |
| 162 | +</script> |
| 163 | +++++ |
| 164 | + |
| 165 | +{empty} + |
| 166 | + |
| 167 | +And this is another of a video from YouTube |
| 168 | +++++ |
| 169 | +<iframe width="100%" height="315" src="http://www.youtube-nocookie.com/embed/UoBUXOOdLXY?rel=0&controls=0&showinfo=0" frameborder="0" allowfullscreen></iframe> |
| 170 | +++++ |
| 171 | +// HINT: Please remember to set the iframe width to 100% to have the video responsive on all our platforms |
| 172 | + |
| 173 | +{empty} + |
| 174 | + |
| 175 | +And here some slides from Sideshare, yay! |
| 176 | +++++ |
| 177 | +<iframe src="http://www.slideshare.net/slideshow/embed_code/4430242" width="100%" height="355" frameborder="0" marginwidth="0" marginheight="0" scrolling="no" style="border:1px solid #CCC; border-width:1px; margin-bottom:5px; max-width: 100%;" allowfullscreen> </iframe> <div style="margin-bottom:5px"> <strong> <a href="//www.slideshare.net/damellis/introduction-to-arduino-4430242" title="Introduction to Arduino" target="_blank">Introduction to Arduino</a> </strong> from <strong><a href="//www.slideshare.net/damellis" target="_blank">David Mellis</a></strong> </div> |
| 178 | +++++ |
| 179 | +// HINT: Please remember to set the iframe width to 100% to have the slide show responsive on all our platforms |
| 180 | + |
| 181 | +{empty} + |
| 182 | + |
| 183 | +And this is some audio from SoundCloud |
| 184 | +++++ |
| 185 | +<iframe width="100%" height="450" scrolling="no" frameborder="no" src="https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/playlists/55323777&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&visual=true"></iframe> |
| 186 | +++++ |
| 187 | +// HINT: Please remember to set the iframe width to 100% to have the sound UI responsive on all our platforms |
0 commit comments