Azure Arc Jumpstart Documentation

This repository contains the files to create the "Azure Arc Jumpstart" website built from the markdown files located in the project core repository.

Overview

This docs is built using Hugo with the Docsy theme, hosted through Netlify.

Pre-requisites

• Hugo/Hugo extended
• Node.js

Local Environment Setup

1. Ensure pre-requisites are installed

2. Clone this repository

   git clone https://github.com/microsoft/azure_arc_jumpstartweb

3. Go to main directory

   cd ./azure_arc_jumpstartweb

4. Update submodules:

   git submodule update --init --recursive

5. Install npm packages:

   npm install

6. Run in local

   npm run start

Update docs

Docs contents are imported as a submodule. You have to edit & update docs content in the production repository or edit the content in website.

Algolia Docsearch

• set enable algolia docsearch in the config.toml

algolia_docsearch = true

• layouts/partials/hooks/head-end.html

{{ with .Site.Params.algolia_docsearch }}
<!-- stylesheet for algolia docsearch -->
{{ end }}

• layouts/partials/hooks/body-end.html

{{ with .Site.Params.algolia_docsearch }}
<!-- scripts for algolia docsearch -->
{{ end }}

Navbar Menu

In the config.toml

# Navbar Menu

[menu]
    [[menu.main]]
        name="About"
        url="https://github.com/microsoft/azure_arc"
        weight=1
    
# [[menu.main]]
#       name="Test"
#       url="..."
#       weight=2