How to build with Hexo
Static application
Hexo is listed on the Jamstack documentation as a static site generator, aligned to the Jamstack approach.
Learn more about Hexo.
Requirements
Section titled RequirementsBefore getting started, you must have:
- An Azion platform account with Edge Functions enabled.
- The latest version of Azion CLI installed.
- Code editor.
- Access to the terminal.
- Node.js ≥ 18.
Initializing an Hexo project on the edge
Section titled Initializing an Hexo project on the edgeNow, it’s time to initialize a Hexo project using the Azion CLI.
- Initialize the project:
- Accept the suggested name to your project, or enter a name:
Output:
- Choose the Hexo template:
Now, Hexo’s CLI will follow the process and initialize your Hexo project.
- With the template fetched and configured, you can now start a local development server.
The following steps are based on the answer you gave.
- If you chose to have a local development server running.
- If you chose not to have a local development server running.
Answering yes to local dev
Section titled Answering yes to local dev- Install the project dependencies. Input
y
when the interaction prompts:
Wait until the installation is complete.
Output:
- On the browser, go to
http://localhost:3000/
and you can now see your Hexo project running.
Deploying the project
Section titled Deploying the projectWhen your project is running locally, you’re still able to deploy it to the edge. To do so:
-
Stop the terminal execution with
control + c
. -
Access the project folder:
- Deploy the project:
- Wait while the project is built and deployed to the Azion Edge Platform.
After the deployment is complete, you’ll receive a domain to access your Hexo project on the Azion Platform.
Wait a few minutes so the propagation takes place, and then access your application using the provided domain, which should be similar to https://xxxxxxx.map.azionedge.net
.
Answering no to local dev
Section titled Answering no to local devNow, after indicating you don’t want to have a local server running, deploy your Hexo project to the edge.
- Enter
y
to the following interaction, indicating you want to deploy the project:
- Install the project dependencies. Input
y
when the interaction prompts:
- Wait while the project is built and deployed to the Azion Edge Platform.
After the deployment is complete, you’ll receive a domain to access your Hexo project on the Azion Platform.
Wait a few minutes so the propagation takes place, and then access your application using the provided domain, which should be similar to https://xxxxxxx.map.azionedge.net
.
Contributors