Skip to content

Commit

Permalink
Merge pull request #12 from nodedge/feature/website
Browse files Browse the repository at this point in the history
Add website
  • Loading branch information
EnricaSo committed Oct 30, 2022
2 parents d08c0b3 + 1b174f7 commit ea9506e
Show file tree
Hide file tree
Showing 97 changed files with 216 additions and 17 deletions.
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ htmlcov/
.mypy_cache
venv/
venv38/
docs/build/
docs_sphinx/build/
dist/
build/
_template/
Expand Down
6 changes: 3 additions & 3 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -53,9 +53,9 @@ repos:
types: [python]
stages: [push]
pass_filenames: false
- id: docs
name: run checks on docs building
entry: tox -e docs
- id: docs_sphinx
name: run checks on docs_sphinx building
entry: tox -e docs_sphinx
language: system
types: [python]
stages: [push]
Expand Down
2 changes: 1 addition & 1 deletion .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ jobs:
- python: 3.10
env: TOXENV=packaging
- python: 3.10
env: TOXENV=docs
env: TOXENV=docs_sphinx


before_script:
Expand Down
6 changes: 3 additions & 3 deletions MANIFEST.in
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,9 @@ recursive-include tools *
recursive-exclude * __pycache__
recursive-exclude * *.py[co]

recursive-include docs *.rst *.py Makefile make.bat *.png
recursive-include docs/source/_templates *
recursive-exclude docs/build *
recursive-include docs_sphinx *.rst *.py Makefile make.bat *.png
recursive-include docs_sphinx/source/_templates *
recursive-exclude docs_sphinx/build *

include *.txt
recursive-include nodedge *
Expand Down
Empty file added docs/.nojekyll
Empty file.
1 change: 1 addition & 0 deletions docs/CNAME
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
www.nodedge.io
25 changes: 25 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# What is Nodedge?

Nodedge is a powerful graphical-programming environment designed by engineers for engineers. It lets you design multi-domain simulations by drag-and-dropping built-in graphic blocks.

Nodedge is open-source, and it is written in Python, today's number one scripting language. It provides you with a Python command line, the possibility to customize your block, and generate Python code from your diagrams. Nodedge graphical interface is based on PySide6 to access to the complete Qt framework for next-generation user experience.

Nodedge is multi-purpose.
Currently, Nodedge provides a graphical scripting environment with real-time evaluation.
Our short-term goal is to provide support for **system design**, **simulation**, and **data plotting and analysis**.
Our mid-term goal is to add support for robotics-specific features, such as **embedded code generation** for common hardware platform, real-time data acquisition and inspection.

</br>
<center><img src="media/nodedge_interface.png" alt="nodedge_interface" width="500" /></center>

# Getting started

For getting started [download](https://github.com/nodedge/nodedge/releases/download/v0.2.3/NodedgeSetup.exe) our software or clone our repository from [Github](https://github.com/nodedge/nodedge).

# Roadmap

Nodedge is undergoing a major development phase.
We are working hard to provide you with unique features:
* a versatile and customizable plotting environment for the analysis of time series
* support of the most common data file format
* a simulation environment for the simulation of physical models, chemical processes, robotic systems, and many others
18 changes: 18 additions & 0 deletions docs/_coverpage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
<!-- _coverpage.md -->

<!-- ![logo](media/nodedge_logo.png) -->
<img src="media/nodedge_logo.png" alt="logo" width="100"/>

# Nodedge <small>0.2</small>

> An open-source graphic environment for next-generation engineering.
- Design. Simulate. Inspect.

[Download](https://github.com/nodedge/nodedge/releases/download/v0.2.3/NodedgeSetup.exe)
[GitHub](https://github.com/nodedge/nodedge)
[Donate]()

<!-- background color -->

![color](#f0f0f0)
14 changes: 14 additions & 0 deletions docs/_navbar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<!-- _navbar.md -->

* [Home](/)
* [Features](features.md)
* [Resources](resources.md)
* [About](about.md)

<!--
* Language
* [:us: EN](/)
* [:fr: FR](/fr/)
* [:it: IT](/it/)
-->
Empty file added docs/_sidebar.md
Empty file.
33 changes: 33 additions & 0 deletions docs/about.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Our mission
Nodedge's mission is to redefine the standards of scientific scripting and model-based design.
Nodedge is the first **free and open-source** graphic environment for scientists and engineers.
It is based on the **latest-generation technology** for a user experience that has never been so enjoyable.

# Our vision
Why should scientific knowledge be only for a few? By making Nodedge open source and free, we intend to
**democratize knowledge**, **incentivize collaboration**, and give everyone the tool they deserve to create the
**innovations of tomorrow**.

# Meet our team

<p style="text-align: center;">
<font size="5"> <b>Enrica Soria</b> </font> <br />
Developer and operations
</p>

<p style="text-align: center;">
<font size="5"> <b>Anthony De Bortoli</b> </font> <br />
Main developer
</p>

<p style="text-align: center;">
<img src="media/pongy.jpg" alt="pongy" width="180"/> <br />
<font size="5"> <b>Pongy</b> </font> <br />
Our mascotte
</p>

# Our contacts

**Address**: Lausanne (1005), Switzerland<br />
**Email**: [admin@nodedge.io](mailto:admin@nodedge.io)<br />
**Telephone**: (+41) 076 448 14 24
26 changes: 26 additions & 0 deletions docs/features.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Graphical programming
Nodedge provides you with a complete environment for graphical programming.
Instead of writing complex lines of text code, you can focus on the logical flow
and create your program by simply combining built-in blocks, the *nodes* in a
diagram-like structure with *edges*. This modern paradigm
allows you rapid prototyping, software testing, and verification.

Nodes allow you to perform mathematical operations, simulate plants, process signals,
design and reuse patterns, and perform many others. They can be easily dragged and drop
from the node list, and configured to your needs. You can also create your own custom nodes
and share them with other users.

# Source code access
Nodedge is the first scientific editor with source code access. Its code is freely accessible and auditable on Github.
This allows the community to contribute, engage, audit, report and fix issues.
Nodedge is written in Python3, the most popular scripting language.
The graphics is based on Qt, the industry-leading framework for interfaces that users love.

# Portability and collaboration

Nodedge is cross-platform. You can install it on Windows, MacOS, and Linux.
Nodedge project files are saved in a JSON format, which makes portability and versioning
easy. For next-level collaboration experience, we aim at making simultaneous editing possible.
You and your colleagues will be able to access the same project, from anywhere, with no conflicts
or latencies.

35 changes: 35 additions & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="description" content="Description">
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">

<!-- Basic theme
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4/lib/themes/vue.css">
-->

<!-- Theme: Simple (light + dark) -->
<link rel="stylesheet" media="(prefers-color-scheme: light)" href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple.css">
<link rel="stylesheet" media="(prefers-color-scheme: dark)" href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple-dark.css">


<link rel="icon" href="media/nodedge_logo.png">
</head>
<body>
<div id="app"></div>
<script>
window.$docsify = {
name: '',
repo: '',
coverpage: true,
loadNavbar: true
}
</script>
<!-- Docsify v4 -->
<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
<script src="//unpkg.com/docsify/lib/plugins/emoji.min.js"></script>
</body>
</html>
14 changes: 14 additions & 0 deletions docs/keywords.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
graphical-editor
visual-scripting
block-diagram
automated-research
physical-systems
simulation
engineering
robotics
python3
qt6
pyside6
windows
macos
linux
Binary file added docs/media/add_edge.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/add_node.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/nodedge_interface.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/nodedge_logo.ico
Binary file not shown.
Binary file added docs/media/nodedge_logo.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/pongy.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/rename_nodes_02.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/zoom_in_out.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
33 changes: 33 additions & 0 deletions docs/resources.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Documentation

Nodedge’s user manual is available online and is automatically updated every time the API is updated.

* [Nodedge user manual](https://nodedge.readthedocs.io/en/latest/)
* [Github wiki](https://github.com/nodedge/nodedge/wiki)

# Examples

The list of examples is growing day by day.
Find some [here](https://github.com/nodedge/nodedge/tree/master/examples).

# Tutorials

Here we offer a collection of free tutorials to get started with Nodedge and to explore the more advanced Nodedge features.
This library is greatly under construction, we would appreciate your help in improving it!

> Add a node
![](media/add_node.gif)

> Add an edge
![](media/add_edge.gif)

> Rename a node
![](media/rename_nodes_02.gif)

> Navigate the scene
![](media/zoom_in_out.gif)

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
8 changes: 4 additions & 4 deletions readthedocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,18 @@
# Required
version: 2

# Build documentation in the docs/ directory with Sphinx
# Build documentation in the docs_sphinx/ directory with Sphinx
sphinx:
configuration: docs/source/conf.py
configuration: docs_sphinx/source/conf.py

# Build documentation with MkDocs
#mkdocs:
# configuration: mkdocs.yml

# Optionally build your docs in additional formats such as PDF and ePub
# Optionally build your docs_sphinx in additional formats such as PDF and ePub
formats: all

# Optionally set the version of Python and requirements required to build your docs
# Optionally set the version of Python and requirements required to build your docs_sphinx
python:
version: 3.6
install:
Expand Down
10 changes: 5 additions & 5 deletions tox.ini
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[tox]
envlist = begin,py38,py39,py310,black, packaging,coverage,mypy,docs
;envlist = {py38,py39,py310}-{linux,macos,windows}, {begin,black, packaging,coverage,mypy,docs}-{windows}
envlist = begin,py38,py39,py310,black, packaging,coverage,mypy,docs_sphinx
;envlist = {py38,py39,py310}-{linux,macos,windows}, {begin,black, packaging,coverage,mypy,docs_sphinx}-{windows}

[default]
basepython = python3.10
Expand Down Expand Up @@ -83,8 +83,8 @@ commands =
coverage html
codecov -e CODECOV_TOKEN

[testenv:docs]
changedir = docs
[testenv:docs_sphinx]
changedir = docs_sphinx
deps = -rrequirements_docs.txt
commands =
sphinx-build -b html -d {envtmpdir}/doctrees ./source {envtmpdir}/html
Expand All @@ -94,7 +94,7 @@ python =
3.7: py37
3.8: py38
3.9: py39
3.10: py310, mypy, flake8, black, coverage, packaging, docs
3.10: py310, mypy, flake8, black, coverage, packaging, docs_sphinx

;[gh-actions:env]
;PLATFORM =
Expand Down

0 comments on commit ea9506e

Please sign in to comment.