mirror of
https://github.com/n8n-io/n8n-docs.git
synced 2026-03-27 09:28:43 +07:00
Finish restructure of wiki
This commit is contained in:
@@ -65,17 +65,17 @@ module.exports = {
|
||||
text: 'Getting Started',
|
||||
link: '/',
|
||||
},
|
||||
{
|
||||
text: 'Guides',
|
||||
link: '/guides/guides.md'
|
||||
},
|
||||
// {
|
||||
// text: 'Guides',
|
||||
// link: '/guides/guides.md'
|
||||
// },
|
||||
{
|
||||
text: 'Nodes',
|
||||
link: '/nodes/nodes.md'
|
||||
link: '/nodes/nodes.md',
|
||||
},
|
||||
{
|
||||
text: 'Reference',
|
||||
link: '/reference/reference.md'
|
||||
link: '/reference/reference.md',
|
||||
},
|
||||
{
|
||||
text: 'Community',
|
||||
@@ -83,27 +83,27 @@ module.exports = {
|
||||
},
|
||||
],
|
||||
sidebar: {
|
||||
'/guides/': [
|
||||
{
|
||||
title: 'Guide Overview',
|
||||
sidebarDepth: 2,
|
||||
children: getChildrenFiles('guides', 'guides.md'),
|
||||
},
|
||||
],
|
||||
// '/guides/': [
|
||||
// {
|
||||
// title: 'Guide Overview',
|
||||
// sidebarDepth: 2,
|
||||
// children: getChildrenFiles('guides', 'guides.md'),
|
||||
// },
|
||||
// ],
|
||||
|
||||
'/nodes/': [
|
||||
{
|
||||
title: 'Node Overview',
|
||||
title: '🧬 Overview',
|
||||
sidebarDepth: 2,
|
||||
children: getChildrenFiles('nodes', 'nodes.md'),
|
||||
},
|
||||
{
|
||||
title: 'Creating Nodes',
|
||||
title: '🔬 Creating Nodes',
|
||||
sidebarDepth: 2,
|
||||
children: getChildrenFiles('nodes/creating-nodes', 'create-node.md'),
|
||||
},
|
||||
{
|
||||
title: 'Nodes Library',
|
||||
title: '🧠 Nodes Library',
|
||||
sidebarDepth: 3,
|
||||
children: [
|
||||
{
|
||||
@@ -132,27 +132,87 @@ module.exports = {
|
||||
|
||||
'/reference/': [
|
||||
{
|
||||
title: 'Reference Overview',
|
||||
sidebarDepth: 2,
|
||||
children: getChildrenFiles('reference', 'reference.md'),
|
||||
title: '📚 Overview',
|
||||
path: 'reference.md',
|
||||
},
|
||||
{
|
||||
title: 'Data',
|
||||
title: '🧐 Changelog',
|
||||
path: 'changelog.md',
|
||||
},
|
||||
{
|
||||
title: '🎯 Workflow',
|
||||
path: 'workflow.md',
|
||||
},
|
||||
{
|
||||
title: '⚙️ Configuration',
|
||||
path: 'configuration.md',
|
||||
},
|
||||
{
|
||||
title: '🚔 Security',
|
||||
path: 'security.md',
|
||||
},
|
||||
{
|
||||
title: '📦 Docker',
|
||||
path: 'docker.md',
|
||||
},
|
||||
{
|
||||
title: '🖥 Server Setup',
|
||||
path: 'server-setup.md',
|
||||
},
|
||||
{
|
||||
title: '👾 Start Workflow via CLI',
|
||||
path: 'start-workflows-via-cli.md',
|
||||
},
|
||||
{
|
||||
title: '👀 Troubleshooting',
|
||||
path: 'troubleshooting.md',
|
||||
},
|
||||
{
|
||||
title: '💾 Data',
|
||||
sidebarDepth: 2,
|
||||
children: getChildrenFiles('reference/data'),
|
||||
},
|
||||
{
|
||||
title: '💻 Development',
|
||||
path: 'development.md',
|
||||
},
|
||||
{
|
||||
title: '⌨️ Keyboard Shortcuts',
|
||||
path: 'keyboard-shortcuts.md',
|
||||
},
|
||||
{
|
||||
title: '🎫 License',
|
||||
path: 'license.md',
|
||||
},
|
||||
{
|
||||
title: '❓ FAQ',
|
||||
path: 'faq.md',
|
||||
},
|
||||
],
|
||||
|
||||
'/': [
|
||||
{
|
||||
title: 'Introduction',
|
||||
title: '👋 Introduction',
|
||||
collapsable: false,
|
||||
path: '/',
|
||||
sidebarDepth: 0,
|
||||
},
|
||||
'getting-started/quickstart.md',
|
||||
'getting-started/workflow.md',
|
||||
'getting-started/start-workflows-via-cli.md',
|
||||
{
|
||||
title: '🚀 Quickstart',
|
||||
path: 'getting-started/quickstart.md',
|
||||
},
|
||||
{
|
||||
title: '🍄 Key Components',
|
||||
path: 'getting-started/key-components.md',
|
||||
},
|
||||
{
|
||||
title: '💪 Creating Your First Workflow',
|
||||
path: 'getting-started/creating-your-first-workflow.md',
|
||||
},
|
||||
{
|
||||
title: '🤔 What\'s Next?',
|
||||
path: 'getting-started/whats-next.md',
|
||||
},
|
||||
],
|
||||
// [
|
||||
// {
|
||||
|
||||
2
docs/getting-started/creating-your-first-workflow.md
Normal file
2
docs/getting-started/creating-your-first-workflow.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# Creating Your First Workflow
|
||||
|
||||
25
docs/getting-started/key-components.md
Normal file
25
docs/getting-started/key-components.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# Key Components
|
||||
|
||||
|
||||
## Connection
|
||||
|
||||
A connection establishes a link between nodes to route data through the workflow. Each node can have one or multiple connections.
|
||||
|
||||
|
||||
## Node
|
||||
|
||||
A node is an entry point for retrieving data, a function to process data or an exit for sending data. The data process includes filtering, recomposing and changing data. There can be one or several nodes for your API, service or app. You can easily connect multiple nodes, which allows you to create simple and complex workflows with them intuitively.
|
||||
|
||||
For example, consider a Google Sheets node. It can be used to retrieve or write data to a Google Sheet.
|
||||
|
||||
|
||||
## Trigger Node
|
||||
|
||||
A trigger node is a node that starts a workflow and supplies the initial data. What triggers it, depends on the node. It could be the time, a webhook call or an event from an external service.
|
||||
|
||||
For example, consider a Trello trigger node. When a Trello Board gets updated, it will trigger a workflow to start using the data from the updated board.
|
||||
|
||||
|
||||
## Workflow
|
||||
|
||||
A workflow is a canvas on which you can place and connect nodes. A workflow can be started manually or by trigger nodes. A workflow run ends when all active and connected nodes have processed their data.
|
||||
@@ -1 +1,75 @@
|
||||
# Quickstart
|
||||
# Quickstart
|
||||
|
||||
|
||||
## Give n8n a spin
|
||||
|
||||
To spin up n8n, you can run:
|
||||
|
||||
```bash
|
||||
npx n8n
|
||||
```
|
||||
|
||||
It will download everything that is needed to start n8n.
|
||||
|
||||
You can then access n8n by opening:
|
||||
[http://localhost:5678](http://localhost:5678)
|
||||
|
||||
## Run with docker
|
||||
|
||||
To play around with n8n, you can also start it using docker:
|
||||
|
||||
```bash
|
||||
docker run -it --rm \
|
||||
--name n8n \
|
||||
-p 5678:5678 \
|
||||
n8nio/n8n
|
||||
```
|
||||
|
||||
Be aware that all the data will be lost once the docker container gets removed. To
|
||||
persist the data mount the `~/.n8n` folder:
|
||||
|
||||
```bash
|
||||
docker run -it --rm \
|
||||
--name n8n \
|
||||
-p 5678:5678 \
|
||||
-v ~/.n8n:/root/.n8n \
|
||||
n8nio/n8n
|
||||
```
|
||||
|
||||
More information about the Docker setup can be found in the README file of the
|
||||
[Docker Image](https://github.com/n8n-io/n8n/blob/master/docker/images/n8n/README.md).
|
||||
|
||||
In case you run into issues, check out the [troubleshooting](troubleshooting.md) page or ask for help in the community [forum](https://community.n8n.io/).
|
||||
|
||||
## Install with npm
|
||||
|
||||
To install n8n globally:
|
||||
|
||||
```bash
|
||||
npm install n8n -g
|
||||
```
|
||||
|
||||
### Start
|
||||
|
||||
After the installation n8n can be started by simply typing in:
|
||||
|
||||
```bash
|
||||
n8n
|
||||
# or
|
||||
n8n start
|
||||
```
|
||||
|
||||
|
||||
### Start with tunnel
|
||||
|
||||
!> **WARNING**: This is only meant for local development and testing. It should not be used in production!
|
||||
|
||||
To be able to use webhooks for trigger nodes of external services like GitHub, n8n has to be reachable from the web. To make that easy, n8n has a special tunnel service, which redirects requests from our servers to your local n8n instance (uses this code: [https://github.com/localtunnel/localtunnel](https://github.com/localtunnel/localtunnel)).
|
||||
|
||||
To use it, simply start n8n with `--tunnel`
|
||||
|
||||
```bash
|
||||
n8n start --tunnel
|
||||
```
|
||||
|
||||
In case you run into issues, check out the [troubleshooting](troubleshooting.md) page or ask for help in the community [forum](https://community.n8n.io/).
|
||||
|
||||
2
docs/getting-started/whats-next.md
Normal file
2
docs/getting-started/whats-next.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# What's Next?
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# Create Node
|
||||
# Creating a Node
|
||||
|
||||
It is quite easy to create your own nodes in n8n. Mainly three things have to be defined:
|
||||
|
||||
|
||||
@@ -1 +1,3 @@
|
||||
# Mandrill
|
||||
|
||||
Mandrill is a Mailchimp add-on. Please refer to the [MailChimp credential docs](https://github.com/n8n-io/n8n-docs/tree/master/docs/credentials/MailChimp)!
|
||||
1
docs/reference/changelog.md
Normal file
1
docs/reference/changelog.md
Normal file
@@ -0,0 +1 @@
|
||||
# Changelog
|
||||
7
docs/reference/docker.md
Normal file
7
docs/reference/docker.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# Docker
|
||||
|
||||
Detailed information about how to run n8n in Docker can be found in the README
|
||||
of the [Docker Image](https://github.com/n8n-io/n8n/blob/master/docker/images/n8n/README.md).
|
||||
|
||||
A basic step by step example setup of n8n with docker-compose and Let's Encrypt is available on the
|
||||
[Server Setup](server-setup.md) page.
|
||||
Reference in New Issue
Block a user