Repository architecture - Cloud

Talend Cloud API Designer User Guide

Version
Cloud
Language
English
Product
Talend Cloud
Module
Talend API Designer
Content
Design and Development > Designing APIs
Last publication date
2024-03-13

The repository used to build and publish the portal is structured as follows:

Element Description
.github This folder contains configuration files for GitHub Actions, which are used to deploy to GitHub Pages or Azure Static Web Apps for example.
apis This folder contains the API documentation to publish. It should have a folder for each API, and each of these should contain a folder per version. The documentation for an API version is located in apis/<api-name>/<api-version>/index.md.

With the Talend Cloud API Designer user interface, this structure is automatically created when you publish an API.

assets This folder contains files managed by the user, such as JavaScript and CSS files.
content This folder contains any other page that you want to include in your portal. By default it contains a landing page and a "Getting started" page.
static This folder contains static files managed by the user, such as images and fonts.
themes This folder contains the theme for the portal. It is provided by Talend and editing it is not recommended. If you want to customize the theme, see Customizing your portal.
config.toml This file contains the configuration for the portal. It specifies the theme to use when generating the site and allows you to organize your APIs into categories. For more information, see Organizing your API list.