Lấy mã
- Đăng nhập và lưu dự án. Bản nhúng trỏ tới một dự án trong tài khoản của bạn, nên một dự án chỉ nằm trong trình duyệt này sẽ không thể nhúng được.
- Nhấn Chia sẻ, rồi chọn Nhúng ở cuối bảng chia sẻ.
- Chọn kích thước và các tùy chọn. Phần xem trước bên dưới chính là bản nhúng.
- Chọn HTML, Markdown hoặc Liên kết, nhấn Sao chép mã, rồi dán vào trang của bạn.
Bản nhúng cần một dự án mà bất kỳ ai có liên kết đều có thể mở. Với dự án riêng tư của chính bạn, dòng Nhúng sẽ cho biết trước nó sẽ làm gì: Mở cho bất kỳ ai có liên kết, rồi sao chép mã. Chia sẻ liên kết là miễn phí trên mọi gói. Khi chưa đăng nhập, dòng này hiện Với tài khoản miễn phí và yêu cầu bạn đăng nhập. Học sinh trong một lớp học không thể nhúng: dự án lớp học luôn ở chế độ riêng tư.
Các tùy chọn
| Tùy chọn | Lựa chọn |
|---|---|
| Độ dày | Chiều rộng theo cột (mặc định), hoặc 480, 600 hay 800 px |
| Chiều cao (px) | Từ 200 đến 1200; mặc định là 400 |
| Giao diện | Theo hệ thống của người xem, Sáng hoặc Tối |
| Mở ra ở | Mạch, Code, hoặc Cả hai, nằm cạnh nhau |
| Code mở ở | Tệp chính hoặc tab khác, với dự án có nhiều tệp |
| Tự chạy khi xuất hiện trên màn hình | Bật mặc định |
| Ẩn code | Tắt mặc định; khi bật, tab Code biến mất hẳn |
| Hiện "Remix trong Mokxi" | Bật mặc định |
Ba định dạng:
- HTML là một
<iframe>dành cho WordPress, Ghost, Notion, trường nhúng của Medium và bất kỳ trang web nào. - Markdown dành cho README trên GitHub, vốn không hiển thị khung nhúng: một hình ảnh của dự án liên kết tới trang của nó, nơi dự án chạy được.
- Liên kết là địa chỉ thuần của bản nhúng, cho bất cứ nơi nào nhúng bằng liên kết.
HTML trông như thế này:
<iframe src="https://mokxi.com/embed/abc123" width="100%" height="400"
style="border:0;max-width:100%;border-radius:8px" loading="lazy"
title="Traffic light, running in Mokxi"></iframe>
Các tùy chọn được ghi ngay vào địa chỉ, nên bạn cũng có thể tự sửa: theme=dark, view=code hoặc view=split, autorun=0, height=480, hideCode=1, start=notes.h và edit=0. Bất cứ điều gì bản nhúng không hiểu sẽ quay về mặc định, nên một bản nhúng đã dán vẫn tiếp tục hoạt động.
Người đọc thấy gì
- Mạch điện, với nút Chạy chuyển thành Dừng khi đang chạy.
- Các tab Mạch và Code, hoặc cả hai nằm cạnh nhau, trừ khi bạn đã ẩn code.
- Remix trong Mokxi, mở ra một bản sao của riêng họ trong trình soạn thảo.
Mạch chạy chính sketch của bạn. Khi bạn mở trình tạo bản nhúng, Mokxi biên dịch và lưu chương trình cho từng bo mạch, và dòng dưới phần xem trước hiện Sẵn sàng: bản nhúng chạy chính code của bạn. Một bo mạch không biên dịch được sẽ hiện Mở trong Mokxi để chạy trong bản nhúng thay vì chạy bất cứ thứ gì khác. Nhấn Chạy trong trình soạn thảo để kiểm tra sketch, rồi mở Nhúng lại.
Bản nhúng cho thấy mạch đang chạy. Để nhấn các nút, đọc dữ liệu serial hoặc sửa code, người đọc mở nó trong Mokxi.
Khi bật Tự chạy khi xuất hiện trên màn hình, mạch bắt đầu chạy khi khung cuộn vào màn hình, và trình mô phỏng chỉ được tải về lúc đó. Một trang có nhiều bản nhúng vẫn giữ được tốc độ. Người đọc mà hệ thống yêu cầu giảm chuyển động sẽ thấy nút Chạy thay thế.
Các gói và dòng ghi công
Nhúng có trên mọi gói. Trên gói Free, bản nhúng kèm một dòng nhỏ dưới mạch: Made with Mokxi · Build your own. Các gói Pro, giá học sinh và Classroom nhúng không kèm dòng này, và bản dùng thử Pro cũng vậy. Tác phẩm của học sinh trong lớp hoặc của trẻ em không bao giờ hiện dòng này hay Remix trong Mokxi.
Các dự án dựng sẵn cũng có thể nhúng, tại /embed/example/<name>, ví dụ https://mokxi.com/embed/example/traffic-light. Bản nhúng của một dự án dựng sẵn kèm cùng dòng đó trên mọi site, trừ chính site của Mokxi.
Trang riêng của một dự án công khai có sẵn mã nhúng để sao chép, nằm dưới danh sách linh kiện: Đặt mạch này vào trang của riêng bạn.
Nếu không chạy được
- "Dự án này là riêng tư hoặc không còn tồn tại." Dự án đã bị đặt riêng tư hoặc bị xóa. Đặt lại mức truy cập của nó thành Liên kết hoặc Thư viện trong trang chia sẻ, và cùng một mã sẽ hoạt động trở lại.
- "Mở trong Mokxi để chạy" trên một bo mạch. Code của nó đã bị sửa và chưa có bản biên dịch đã lưu. Mở dự án, nhấn Chạy, rồi mở Chia sẻ và Nhúng lại.
- Khung trống trong README. GitHub không hiển thị khung nhúng: hãy dùng định dạng Markdown.
- Các thay đổi không hiện ra. Bản nhúng hiển thị dự án như trạng thái đã lưu hiện tại. Lưu lại, rồi tải lại trang chứa bản nhúng.
Related
- Chia sẻ một dự án
- Xuất và tải xuống
- Cách bản nhúng hoạt động, với một ví dụ trực tiếp