MarlinFirmware/MarlinDocumentation là dự án JavaScript với 404 sao. Marlin Firmware Documentation Project
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
This repository contains the raw documentation for Marlin 3D printer firmware which is automatically deployed to marlinfw.org. This documentation is open and available on GitHub so anyone may contribute by completing, correcting, or creating articles.
Table of Contents
Technical details
How to contribute
Local Jekyll preview
Installing Ruby on Windows
Installing Ruby on macOS
Installing Ruby on Ubuntu
Set up Marlin Documentation project
Jekyll basics
Previewing content
License
Technical details
The Marlin Documentation Project is built using the following technologies:
Ruby
RubyGems
Jekyll
GitHub Pages
How to contribute
Fork this repository, create a branch, edit or add pages, run the checks, and open a Pull Request against
master. Before you start, read:
AGENTS.md: the repo map, how the site is organized, and the checks every change must pass.
_tools/README.md: the generators (Settings, G-code index, printer directory) and checks.
skills/: step-by-step procedures for common tasks (new page, diagram, G-code page,
settings regeneration), usable by people and by coding agents.
Reference sections (docs/settings/, the G-code index, the printer directory) are generated; edit the
human-owned fields or the page body, not the generated entries. Run _tools/install_hooks.sh once per clone so
the site checks run before every commit.
Local Jekyll preview
If you'd like to be able to preview your contributions before submitting them, you'll need to install Jekyll on your system. Instructions for Windows and macOS are given below:
Installing Ruby on Windows
Download and install a Ruby+Devkit 3.3.4 from RubyInstaller Download Archives. Use default options for installation.
Run the ridk install step on the last stage of the installation wizard. Choose option 3 for MSYS2 and MINGW development tool chain. This is needed for installing gems with native extensions. You can find additional information regarding this in the RubyInstaller Documentation.
[!TIP]
Once the MSYS2 and MINGW development toolchain install is complete, the installation wizard will reprompt which components should be installed. If you see a "Install MSYS2 and MINGW development toolchain succeeded" message above it, you can close the Command Prompt window and continue below.
Open a new Command Prompt so that changes to the PATH environment variable become effective, then check that everything is working:
ruby -v
If ruby 3.3.4 (2024-07-09 revision be1089c8ec) is reported, then proceed to Set up the Marlin Documentation project.
Installing Ruby on macOS
[!NOTE]
Ruby may come preinstalled, but macOS' "system Ruby" is outdated, unmaintained, and not recommended for general use.
There are many popular package managers for macOS, but we'll cover installation with Homebrew & MacPorts.
Install a package manager. You do not need to install both:
Install Homebrew by launching Terminal and running the following command:
Install MacPorts by downloading & installing the correct package for your version of macOS from the Installing MacPorts page.
Either Xcode or Command Line Tools for Xcode are required to install packages with MacPorts. You do not need to install both. These are available for free on Apple's Developer Program website. An Apple Developer Program membership is not required, but you will need to sign in with your Apple ID.
Install chruby and ruby-install:
Homebrew:
brew install chruby ruby-install
MacPorts:
sudo port install chruby ruby-install
Install Ruby 3.3.4:
ruby-install ruby 3.3.4
The configure, build, and install process will take a few minutes.
Quit and relaunch Terminal, then check that everything is working:
ruby -v
It should report ruby 3.3.4 (2024-07-09 revision be1089c8ec). If not, repeat the above steps.
[!NOTE]
When using ruby-install you'll find your Ruby installations in ~/.rubies/ and you can switch between them with chruby. New instances of zsh in Terminal will default to 3.3.4 due to the changes made to ~/.zshrc.
Proceed to Set up the Marlin Documentation project. (Note that bundler is already included.)
Once Ruby is installed, set up the Marlin Documentation project with Bundler. Open Command Prompt or Terminal and cd to the working path of your Marlin Documentation fork. Execute the following commands:
rm -f Gemfile.lock
bundle config set path 'vendor/bundle'
bundle install
[!NOTE]
You only need to execute the above commands once to complete the install. If you see errors at this stage you may need to update your Ruby installation, fix your Ruby environment, or resolve dependencies between the Ruby gems.
Jekyll basics
Jekyll uses a combination of YAML, Markdown, Liquid, and HTML to define the site content and layout. A _config.yml file defines a site structure with "collections" corresponding to sub-folders. The website is "compiled" to produce static HTML and Javascript. The most important folders in the site are:
_layouts contains the page templates (home, article, setting, gcode, tool).
_includes has partials included by the layouts.
docs/<section>/ holds the pages; each section has an index.md and child pages linked by parent:.
_tools/ holds the generators and the checks. See AGENTS.md for the full map.
Previewing content
To start a mini web server and preview your changes, run the following command:
bundle exec jekyll serve --watch --incremental
With the serve --watch --incremental parameters, Jekyll watches local files for changes and triggers an automatic incremental build of the site on every save. It also starts a mini-web server so documentation can be previewed in a browser at http://localhost:4000/.
[!TIP]
The main Marlin repository comes with the mfdoc script containing the commands above as a shortcut to preview the documentation.
License
This documentation is licensed under the GPLv3 license.
Đọc thêm về MarlinFirmware/MarlinDocumentation ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/MarlinFirmware/MarlinDocumentation là nguồn chính thức.
MarlinFirmware/MarlinDocumentation có bao nhiêu sao?
MarlinFirmware/MarlinDocumentation có 404 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/MarlinFirmware/MarlinDocumentation. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
MarlinFirmware/MarlinDocumentation có phải mã nguồn mở không?
Có — MarlinFirmware/MarlinDocumentation phát hành theo license GPL-3.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/MarlinFirmware/MarlinDocumentation.
MarlinFirmware/MarlinDocumentation có trang demo không?
Dự án có trang chủ ở https://marlinfw.org/. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
MarlinFirmware/MarlinDocumentation là gì?
MarlinFirmware/MarlinDocumentation (MarlinFirmware/MarlinDocumentation) là dự án JavaScript trên GitHub. Theo mô tả gốc: Marlin Firmware Documentation Project
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về MarlinDocumentation?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về MarlinDocumentation.