docs: def create_post(self, path, **kw):
          """Create a new post."""
          content = kw.pop('content', None)
          onefile = kw.pop('onefile', False)
          # is_page is not used by create_post as of now.
          kw.pop('is_page', False)
          metadata = {}
          metadata.update(self.default_metadata)
          metadata.update(kw)
          makedirs(os.path.dirname(path))
          if not content.endswith('\n'):
              content += '\n'
          with io.open(path, "w+", encoding="utf8") as fd:
              if onefile:
                  fd.write(write_metadata(metadata, comment_wrap=False, site=self.site, compiler=self))
              fd.write(content)