dennisdoomen/blog

Checklist: Markdown Conversion

Offen

#28 geöffnet am 22.03.2018

 (4 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)HTML (11 Forks)github user discovery
help wanted

Repository-Metriken

Stars
 (1 Stern)
PR-Merge-Metriken
 (Keine gemergten PRs in 30 T)

Beschreibung

(spawned via discussion on #23)

Due to the conversion from Blogger, a lot of the posts are still in HTML format, which can cause problems:

  • The formatting will be off
  • They show as one long string of HTML
  • Other considerations (images, code samples, etc.) have not been covered.

So we'll try to knock these out one at a time in the order of priority, since the site is live.

What we need to do for each post

When converting a post, you'll need to:

  • Rename the post file from .html to .md
  • HTML formatting to markdown formatting
  • Save images to assets/images/posts and reference them from there
  • Mark all code samples in markdown and indicate the language
  • Revise to clean up in another ways as necessary
  • Use {{ site.baseurl }}{% post_url 2010-07-21-name-of-post %} for links between posts
  • Use ![My helpful screenshot]({{ "/assets/screenshot.jpg" | absolute_url }}) for linking to images.

We prefer many small PRs here, so tackle one or two posts at a time, and then check that post off on the list.

Prioritized List of Page Conversions

  • TBD

Contributor Guide