electronjs.org-new

This repository contains the code for the new electronsjs.org website. It is built using Docusaurus 2, a modern static website generator.

Installation

yarn install

How to add a new blogpost

To add a new blogpost you need to create a new markdown file under /blog. The supported frontmatter options are the ones documented in Docusaurus.

There are a couple of things that are different compared to the previous blog engine:

1. There can only be one author. If there are several people working on a post please sign it at the end.
2. The frontmatter date property with the format YYYY-MM-DD is not supported. The options to indicate the date are:
   • Write the date in the filename: YYYY-MM-DD-blogpost-slug
   • Use the output of (new Date('YYYY-MM-DD')).toString() and paste it in the frontmatter section:

     date: 2019-05-13T00:00:00.000Z

To see your changes (and have hot-reload), run the following commands:

yarn prebuild
yarn start

Note: yarn prebuild is only necessary the first time to get content under /docs.

Local Development

If you want to use the contents from electron/electron run the following:

yarn prebuild
yarn start

If you want the website to pick your local documentation, run:

yarn prebuild ../relative/path/to/local/electron/repo
yarn start

For example, if you have the following structure:

└── projects
     ├─ electron
     ├─ electronjs.org-new
     ├─ ...

and assuming your prompt is in /projects/electronjs.org-new/ you will have to run:

yarn prebuild ../electron
yarn start

yarn start starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

Repository content organization

This repository contains the code for 2 related things:

• The code to generate the contents of https://beta.electronjs.org
• create-electron-documentation package

The content of this repository is organized as follows:

└─ root
    |
    ├─ .github/workflows → The definitions for the GitHub actions
    |
    |
    ├─ create-electron-documentation → Code for the npm package
    |        of the same name. Read the readme in the folder
    |        for more information.
    |
    ├─ scripts → The code for the package.json tasks and GitHub
    |        actions
    |
    ├─ spec → Tests for the scripts
    |
    ├─ src → Docusaurus code
    |
    ├─ static → Docusaurus static assets