--- description: Smoketest page title: Testing page hide_from_sitemap: true --- # Heading 1 Most pages don't actually have a H1 heading. The page title from the metadata is automatically inserted. ## Heading 2 This is the highest heading included in the right-nav. To include more heading levels, set `toc_min: 1` in the page-s front-matter. You can go all the way to 6, but if `toc_min` is geater than `toc_max` then no headings will show. ### Heading 3 This is the lowest heading included in the right-nav, by default. To include more heading levels, set `toc_max: 4` in the page's front-matter. You can go all the way to 6. #### Heading 4 This heading is not included in the right-nav. To include it set `toc_max: 4` in the page's front-matter. ##### Heading 5 This heading is not included in the right-nav. To include it set `toc_max: 5` in the page's front-matter. ###### Heading 6 This is probably too many headings. Try to avoid it. This heading is not included in the right-nav. To include it set `toc_max: 6` in the page's front-matter. ## Typography Plain block of text. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. **Inline text styles**: - **bold** - _italic_ - ***bold italic*** - ~~strikethrough~~ - underline - _underline italic_ - **underline bold** - ***underline bold italic*** - `monospace text` - **`monospace bold`** ## Links and images ### Links - [a markdown link](https://docker.com/) - [a markdown link that opens in a new window](https://docker.com/){: target="_blank" class="_" } (the `class="_"` trick prevents Atom from italicizing the whole rest of the file until it encouters another underscore.) - an HTML link - an HTML link that opens in a new window - A link to a Github PR in `docker/docker`: {% include github-pr.md pr=28199 %} - A link to a Github PR in `docker/docker.github.io`: {% include github-pr.md repo=docker.github.io pr=9999 %} (you can also specify `org=foo` to use a Github organization other than Docker). ### Images - A small cute image: ![a small cute image](/images/footer_moby_icon.png) - A small cute image that is a link. The extra newline here makes it not show inline: [![a small cute image](/images/footer_moby_icon.png)](https://www.docker.com/) - A big wide image: ![a pretty wide image](/images/banner_image_24512.png) - The same as above but using HTML: a pretty wide image using HTML [Some Bootstrap image classes](https://v4-alpha.getbootstrap.com/content/images/) might be interesting. You can use them with Markdown or HTML images. - An image using the Bootstrap "thumbnail" class: ![an image as a thumbnail](/images/footer_moby_icon.png){: class="img-thumbnail" } - The same one, but using HTML: a pretty wide image as a thumbnail, using HTML ## Lists - Bullet list item 1 - Bullet list item 2 * Bullet list item 3 1. Numbered list item 1. Two spaces between the period and the first letter helps with alignment. 2. Numbered list item 2. Let's put a note in it. >**Note**: We did it! 3. Numbered list item 3 with a code block in it. You need the blank line before the code block happens. ```bash $ docker run hello-world ``` 4. Numbered list item 4 with a bullet list inside it and a numbered list inside that. - Sub-item 1 - Sub-item 2 1. Sub-sub-item 1 2. Sub-sub-item-2 with a table inside it because we like to party! Indentation is super important. |Header 1 | Header 2 | |---------|----------| | Thing 1 | Thing 2 | | Thing 3 | Thing 4 | ## Tables Some tables in markdown and html. | Permission level | Access | | ---------------- | ------------- | | **Bold** or _italic_ within a table cell. Next cell is empty on purpose. | | | | Previous cell is empty. A `--flag` in mono text. | | Read | Pull | | Read/Write | Pull, push | | Admin | All of the above, plus update description, create and delete | The alignment of the cells in the source doesn't really matter. The ending pipe character is optional (unless the last cell is supposed to be empty). The header row and separator row are optional. If you need block-level HTML within your table cells, such as multiple paragraphs, lists, sub-tables, etc, then you need to make a HTML table. This is also the case if you need to use rowspans or colspans. Try to avoid setting styles directly on your tables! If you set the width on a ``, you only need to do it on the first one. If you have a ``, set it there. > **Note**: If you need to have **markdown** in a **HTML** table, you need to > capture the table and then filter it through `markdownify`. See [tabs](#tabs) > for an example. Here, I avoid that by using HTML throughout.
Left channel Right channel
This is some test text.

This is more text on a new line.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
This is some more text about the right hand side. There is a link here to the Docker Experimental Features README on GitHub.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Go to the docs!

It is dark here. You are likely to be eaten by a grue.

Go to the docs!

It is dark here. You are likely to be eaten by a grue.

## Mixing Markdown and HTML You can use span-level HTML tags within Markdown. You can use a `
` tag to impose an extra newline like here:
You can use entities like ` ` to keep a bunch of words together .
You can use block-level HTML tags too. This paragraph is centered.
Keep reading for more examples, such as creating tabbed content within the page or displaying content as "cards". ## Jekyll / Liquid tricks This paragraph is centered and colored green by setting CSS directly on the element. **Even though you can do this and it's sometimes the right way to go, remember that if we re-skin the site, any inline styles will need to be dealt with manually!** {: style="text-align:center; color: green" } {% assign my-text="foo" %} The Liquid assignment just before this line fills in the following token {{ my-text }}. This will be effective for the rest of this file unless the token is reset. {% capture my-other-text %}foo{% endcapture %} Here is another way: {{ my-other-text }} You can nest captures within each other to represent more complex logic with Liquid. ### Liquid variable scope - Things set in the top level of `_config.yml` are available as site variables, like `{{ site.debug }}`. - Things set in the page's metadata, either via the defaults in `_config.yml` or per page, are available as page variables, like `{{ page.title }}`. - In-line variables set via `assign` or `capture` are available for the remainder of the page after they are set. - If you include a file, you can pass key-value pairs at the same time. These are available as include variables, like `{{ include.toc_min }}`. ## Bootstrap and CSS tricks ### Tabs Here are some tabs:
TAB 1 CONTENT
TAB 2 CONTENT
You need to adjust the IDs and HREFs to match your use case. If you have Markdown inside the content of the `
`, you need to capture it, then print it and run it through the `markdownify` Liquid filter. Here's a demo:
{% capture tab3-content %} #### A Markdown header - list item 1 - list item 2 {% endcapture %} {{ tab3-content | markdownify }}
{% capture tab4-content %} #### Another Markdown header - list item 3 - list item 4 {% endcapture %} {{ tab4-content | markdownify }}
### Cards In a Bootstrap row, your columns need to add up to 12. Here are three cards in a row, each of which takes up 1/3 (4/12) of the row. You need a couple `
`s to clear the row before.

This will take up 1/3 of the row unless the screen is small, then it will take up the whole row.
This will take up 1/3 of the row unless the screen is small, then it will take up the whole row.
This will take up 1/3 of the row unless the screen is small, then it will take up the whole row.
### Columnar text You can use the CSS `column-count` to flow your text into multiple columns. You need a couple `
`s to clear the row before.

This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div. This example uses a HTML div.
This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. This example does it with Markdown. You can't have any blank lines or it will break the Markdown block up. {: style="column-count: 3 "} ## Admonitions (notes) > **Note**: This is a note. > **Info**: This is an info. > **Tip**: This is a tip. > **Warning**: This is a warning. > **Caution**: This is a caution. > **Note**: One line of note text > another line of note text > **Note**: This is a note with a list and a table in it. > > - List item 1 > - List item 2 > > |Table column 1 | Table column 2 | > |----------------|----------------| > | Row 1 column 1 | Row 2 column 2 | > | Row 2 column 1 | Row 2 column 2 | > > And another sentence to top it all off. ## Comments You can use XML style comments, which show up in the HTML "view source", or Liquid ones, which don't. You'll need to view the source of this file to see both styles. {% comment %}This one won't.{% endcomment %} ## Code blocks Rouge provides lots of different code block "hints". If you leave off the hint, it tries to guess and sometimes gets it wrong. These are just a few hints that we use often. ### Raw, no highlighting The raw markup is needed to keep Liquid from interperting the things with double braces as templating language. ```none none with raw {% raw %} $ some command with {{double braces}} $ some other command {% endraw %} ``` ### Raw, Bash ```bash bash with raw {% raw %} $ some command with {{double braces}} $ some other command {% endraw %} ``` ### Bash ```bash $ echo "deb https://packages.docker.com/1.12/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list ``` ### GO ```go incoming := map[string]interface{}{ "asdf": 1, "qwer": []interface{}{}, "zxcv": []interface{}{ map[string]interface{}{}, true, int(1e9), "tyui", }, } ``` ### Python ```python return html.format(name=os.getenv('NAME', "world"), hostname=socket.gethostname(), visits=visits) ``` ### Ruby ```ruby docker_service 'default' do action [:create, :start] end ``` ### JSON Sometimes this doesn't work right and you have to use `none`. ```json "server": { "http_addr": ":4443", "tls_key_file": "./fixtures/notary-server.key", "tls_cert_file": "./fixtures/notary-server.crt" } ``` ### HTML ```html Welcome to nginx! ``` ### Markdown ```md [![Deploy to Docker Cloud](https://files.cloud.docker.com/images/deploy-to-dockercloud.svg)](https://cloud.docker.com/stack/deploy/?repo=) ``` ### ini ```ini [supervisord] nodaemon=true [program:sshd] command=/usr/sbin/sshd -D ``` ### Dockerfile Yes, we have our own highlighting in Rouge! ```dockerfile # # example Dockerfile for https://docs.docker.com/examples/postgresql_service/ # FROM ubuntu RUN apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys B97B0AFCAA1A47F044F244A07FCC7D46ACCC4CF8 RUN echo "deb http://apt.postgresql.org/pub/repos/apt/ precise-pgdg main" > /etc/apt/sources.list.d/pgdg.list RUN apt-get update && apt-get install -y python-software-properties software-properties-common postgresql-9.3 postgresql-client-9.3 postgresql-contrib-9.3 # Note: The official Debian and Ubuntu images automatically ``apt-get clean`` # after each ``apt-get`` USER postgres RUN /etc/init.d/postgresql start &&\ psql --command "CREATE USER docker WITH SUPERUSER PASSWORD 'docker';" &&\ createdb -O docker docker RUN echo "host all all 0.0.0.0/0 md5" >> /etc/postgresql/9.3/main/pg_hba.conf RUN echo "listen_addresses='*'" >> /etc/postgresql/9.3/main/postgresql.conf EXPOSE 5432 VOLUME ["/etc/postgresql", "/var/log/postgresql", "/var/lib/postgresql"] CMD ["/usr/lib/postgresql/9.3/bin/postgres", "-D", "/var/lib/postgresql/9.3/main", "-c", "config_file=/etc/postgresql/9.3/main/postgresql.conf"] ``` ### YAML The `yaml` hint doesn't play nicely with Atom so we sometimes have to use `none`. ```none authorizedkeys: image: dockercloud/authorizedkeys deployment_strategy: every_node autodestroy: always environment: - AUTHORIZED_KEYS=ssh-rsa AAAAB3Nsomelongsshkeystringhereu9UzQbVKy9o00NqXa5jkmZ9Yd0BJBjFmb3WwUR8sJWZVTPFL volumes: /root:/user:rw ```