dennisdoomen/blog

Checklist: Markdown Conversion

オープン

#28 opened on 2018/03/22

 (4 件のコメント) (0 件のリアクション) (0 人の担当者)HTML (11 件のフォーク)github user discovery
help wanted

Repository metrics

Stars
 (1 個のスター)
PR merge metrics
 (30d に merged PR はありません)

説明

(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

コントリビューターガイド