Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/losyoguis/149tresbandas/llms.txt

Use this file to discover all available pages before exploring further.

The Entrenador de Carambola Guiada is fully compatible with Google Sites embedding via the Insert → Embed → URL feature. Once deployed to GitHub Pages, you can paste the public URL into any Google Sites page and the trainer runs inside an iframe with all controls — touch, keyboard, and fullscreen — working as expected.

Embed the Trainer

1

Deploy to GitHub Pages first

The trainer must be publicly hosted before it can be embedded. Follow the GitHub Pages deployment guide to publish your repository and obtain a public URL such as https://losyoguis.github.io/149tresbandas/.
2

Open the target page in Google Sites

Navigate to the Google Sites page where you want to embed the trainer and click the Edit (pencil) icon to enter edit mode.
3

Open the Embed dialog

In the top toolbar, click Insert → Embed.
4

Select the URL tab

In the Embed dialog, select the URL tab (not the “Embed code” tab).
5

Paste the GitHub Pages URL

Paste your GitHub Pages URL (e.g. https://losyoguis.github.io/149tresbandas/) into the URL field and click Insert. A preview of the trainer will appear on the page.
6

Resize the embedded block

Click and drag the embedded block’s resize handles to fit your page layout. For a comfortable table view, the block should be at least 800 px wide. Taller blocks improve usability on desktop; a height of 760 px is recommended.
For the best desktop experience, place the embedded trainer in a full-width section. In Google Sites, insert a new section with a one-column layout and set it to stretch the full page width before adding the embed. This gives the billiards table the maximum available space and keeps all controls visible without scrolling.

Iframe Compatibility Details

Google Sites runs embedded content inside a sandboxed iframe, which restricts certain browser APIs. The Entrenador handles this automatically:
  • Fullscreen mode — if the native Fullscreen API is blocked by the iframe sandbox, the Mesa completa button switches to a CSS full-screen mode instead, expanding the table to fill the embedded container without requiring browser-level fullscreen permissions.
  • Service Worker — the Service Worker registration is wrapped in permission guards so it initialises correctly even when Google Sites limits certain iframe capabilities. Caching and offline support remain active.
  • Touch and keyboard — all touch gestures, keyboard shortcuts (arrows, Enter, Space, F, Escape), and on-screen controls function normally inside the embedded iframe.
Google Drive video iframes may be restricted within the Google Sites sandbox on some accounts or organisation policies. On mobile devices, the trainer automatically switches to a YouTube embed for the video tutorial, which is permitted inside the Google Sites iframe and plays without additional configuration.

Build docs developers (and LLMs) love