Open mairin opened 2 years ago
Gatsby works with Markdown and it can take the data from YAML front matter block. This is done with the installation of gatsby-transformer-remark
plugin. Gatsby offers great performance, SEO and accessibility.
List of tasks
gatsby-source-filesystem
to enhance the project to generate a page from a markdown file and gatsby-plugin-mdx
to implement the use of markdown files that render contents.gatsby-config.js
file.src/pages/index.js
file with the home page content.src/pages
to match the pages for About ChRIS
, About Us
, Join US
, Plugins
, More Info
, For Users
and For Devs
respectively.pages
foldergatsby-plugin-image
with it’s associated dependencies@mairin @jennydaman
We have started using asciidoc rather than markdown for website content and documentation.
Right now chrisproject.org uses jekyll, which is markdown first although we have an asciidoc plugin for it configured. jekyll has a number of problems, it has some technical debt and is a little hard for new contributors to approach, and it has some security issues too.
A pie-in-the-sky idea we had was to use asciidoc-formatted content for multiple outputs - e.g., one adoc file could output a README into a repo, a static HTML page for the website, and a static HTML page for a documentation site.
I investigated using antora and I believe it doesn't support this "multiple output targets per one file" idea, but Gatsby does. It would be very helpful for someone to fork this website repo and investigate converting it to Gatsby.
The ideal outcome of this ticket: