[gimp-web/testing] Fix template file from bad Markdown parsing, rewrite
- From: Pat David <patdavid src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-web/testing] Fix template file from bad Markdown parsing, rewrite
- Date: Thu, 5 May 2016 22:06:13 +0000 (UTC)
commit 654704da77a575236a05387407792cc97ce871df
Author: Pat David <patdavid gmail com>
Date: Thu May 5 17:02:34 2016 -0500
Fix template file from bad Markdown parsing, rewrite
Start adding new content to the file to use as a reference
for new contributors to use.
content/tutorials/template/index.md | 77 +++++++++++++++++++++++++++++-----
1 files changed, 65 insertions(+), 12 deletions(-)
---
diff --git a/content/tutorials/template/index.md b/content/tutorials/template/index.md
index 83058b8..934ec2f 100644
--- a/content/tutorials/template/index.md
+++ b/content/tutorials/template/index.md
@@ -4,22 +4,75 @@ Modified: 2015-10-05T10:19:55-05:00
Author: Pat David
-<del>Text and images Copyright (C) 2002 [AUTHOR NAME](mailto:AUTHOR DOMAIN NAME) and may not be used without
permission of the author.</del>
-
Please use only permissive licensing, such as [CC-BY](http://creativecommons.org/licenses/by/4.0/) or
[CC-BY-SA](http://creativecommons.org/licenses/by-sa/4.0/).
+Something like the following works well:
+
+<small>
+<a href='http://creativecommons.org/licenses/by-sa/3.0/deed.en_US'>
+<img class='cc-badge' src='https://i.creativecommons.org/l/by-sa/3.0/80x15.png' alt='Creative Commons By
Share Alike'/>
+</a>
+<span xmlns:dct="http://purl.org/dc/terms/">GIMP Tutorial - TITLE (text & images)</span> by [Pat
David](http://blog.patdavid.net) is licensed under a [Creative Commons Attribution-ShareAlike 3.0 Unported
License](http://creativecommons.org/licenses/by-sa/3.0/deed.en_US).
+</small>
+
+
+You can use standard [Markdown][] formatting for posts.
+
+[Markdown]: https://daringfireball.net/projects/markdown/syntax
+
+
+## Headings
+
+Headings in Markdown are denoted using two different syntaxes (setext and atx).
+Usually the `<H1>` element of a page is already being used for a title, so the tutorial should use at most
H2 and below.
+Thus, the easiest way to denote headings is using the atx-style:
+
+```markdown
+# This is an H1
+## This is an H2
+### This is an H3
+...
+###### This is an H6
+```
+
+
+## Images
+
+You can insert images using Markdown like this:
+
+```markdown
+![Alt Text](/images/frontpage/wilber-big.png)
+```
+
+You can also use plain html (the Markdown parser will pass it through to the output page):
+
+```html
+<img src="/images/frontpage/wilber-big.png" alt="Alt Text">
+```
+
+In either case, the results will be the same:
+
+![Alt Text](/images/frontpage/wilber-big.png)
-## Sub-heading
- :::html
- <figure>
- <img src="src.png" alt="alt text"/>
- <figcaption>
- A caption
- </figcaption>
- </figure>
+### Better Figures
-Text goes here.
+It may make more semantic sense to encapsulate images inside of `<figure>` tags.
+This will also allow the use of a `<figcaption>` element to provide a caption:
-The original tutorial can be found [here](//www.gimp.org/tutorials).
+```html
+<figure>
+<img src="/images/frontpage/wilber-big.png" alt="Alt Text">
+<figcaption>
+A caption for the image/figure.
+</figcaption>
+</figure>
+```
+Which will result in:
+<figure>
+<img src="/images/frontpage/wilber-big.png" alt="Alt Text">
+<figcaption>
+A caption for the image/figure.
+</figcaption>
+</figure>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]