paulusjacobus / MarlinDocumentation

Marlin Firmware Documentation Project

Home Page:http://marlinfw.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Marlin Documentation Project

Build Status

The aim of this project is to provide a clear and consise documentation of the Marlin 3D printer firmware, we made it open and available on Github so anyone is welcome to contribute by either completing, correcting or creating new arcticles. Please see the chapter "Most wanted contributions" for a list of the current most valuable needed contributions for the documenation project.

Marlin logo

Be safe, have fun and build anything.

Getting started

Marlin Documentation Project is built using the following technologies:

We really recommend reading one of the following tutorials for a quick start with Jekyll:

Instaling buildroot on Windows

  1. Get Ruby for Windows, execute the installer and go through the steps of the installation, make sure to check the “Add Ruby executables to your PATH” box.
  2. Get Ruby Devkit, the download is a self-extracting archive. When you execute the file, it’ll ask you for a destination for the files. Enter a path that has no spaces in it. We recommend something simple, like C:\RubyDevKit\ . Click Extract and wait until the process is finished.
  3. Open your favorite command line tool and do:
  • cd C:\RubyDevKit
  • ruby dk.rb init
  • ruby dk.rb install

How to contribute

Let's pretend you want to add a new article to the project, you should start by forking the MarlinDocumentation repository. Then you should create a new branch, as the new article is about "mashed potatos" we do the following command:

git clone https://github.com/MarlinFirmware/MarlinDocumentation.git
git checkout -b article-mashed_potatos

Then inside the articles folder you should add the new file mashed-potatos.md and let flow all your creativity into it. When you feel it is ready to be shared with the world just submit a commit into your own fork of MarlinDocumentation a start a new Pull Request to upstream.

Previewing content

Jekyll allows you to preview the changes before submitted them to Github, just open a terminal/cmd window chdir to your local copy of the repository and execute the following commands:

bundle install --path vendor/bundle
bundle exec jekyll serve --watch

You only need to execute the bundle install once as it will make sure you have all the required dependencies installed.

Jekyll will watch the local files and on every save you do will trigger an automatic build of the site which can then be easly previewed from your own computer.

Coding style

The preferred format for article contribution is Markdown language.

Most wanted contributions

  1. Transport all documents from old Marlin wiki into this new system.
  2. Create getting started guides to ease the Marlin learning curve for new users.

License

Marlin is published under the GPL license because we believe in open development. The GPL comes with both rights and obligations. Whether you use Marlin firmware as the driver for your open or closed-source product, you must keep Marlin open, and you must provide your compatible Marlin source code to end users upon request. The most straightforward way to comply with the Marlin license is to make a fork of Marlin on Github, perform your modifications, and direct users to your modified fork.

While we can't prevent the use of this code in products (3D printers, CNC, etc.) that are closed source or crippled by a patent, we would prefer that you choose another firmware or, better yet, make your own.

About

Marlin Firmware Documentation Project

http://marlinfw.org

License:GNU General Public License v3.0


Languages

Language:HTML 73.4%Language:CSS 22.1%Language:JavaScript 3.1%Language:Shell 0.9%Language:Ruby 0.6%