dennisdoomen/blog

Checklist: Markdown Conversion

开放

#28 创建于 2018年3月22日

 (4 条评论) (0 个反应) (0 位负责人)HTML (11 个派生)github user discovery
help wanted

仓库指标

星标
 (1 个星标)
PR 合并指标
 (30 天内没有已合并 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

贡献者指南