Writing and publishing lichess blog posts - lichess-org/lila GitHub Wiki

Publish blog post with prismic.io

login to lichess.prismic.io.

Start a new blog post

  • Write something
  • Blog post

Write the blog post

  • Fill in the title, and post body.
  • Fill the content of the Metadata tab.
  • Click the Save button often.
  • Images must be resized before upload. 744px width max.

Careful with collaboration

prismic doesn't deal well with concurrent edits.

  • Synchronize with the team (tell them when you start and stop editing)
  • Always reload the page before you start editing a post, so you start from the latest version

Embed a study chapter

Use the study chapter URL as both the link text and URL.

Embed a game

Use the game URL as both the link text and URL.

Embed a table

Change text type to preformatted and start with "markdown". Then use the markdown table syntax.

Preview the blog post

Click the top-right round eye icon in prismic, then 'prod'

Publish the blog post

When everything is ready and the post was reviewed by other team members, click Publish , then

  • Click Publish on top right
  • Select Publish it now
  • Click Publish

Modify a published blog post

Make modifications to the document, then

  • Click Save
  • Click Publish on top right
  • Select Publish it now
  • Click Publish

Writing documentation?

  • Make sure your document is of type "Documentation"
  • Publish as normal
  • Use Settings -> Bookmarks to generate a lichess.org/page/slug URI for your document