randalschwartz Rules
Converting existing HTML into Jaspr component syntax by hand is prone to errors and wastes time.
- Rule 1: You MUST ALWAYS use the
jaspr convert-htmlcommand to convert existing HTML. - Rule 2: You MUST NEVER attempt to convert HTML to Jaspr code manually.
- Rule 3: You MUST take the output from the daemon UNCHANGED and use it exactly as provided.
Usage
To convert HTML to Jaspr code, run one of the following commands in the terminal depending on your source:
From a local file:
jaspr convert-html --file some/path/to/file.html
From a URL:
jaspr convert-html --url https://example.com
The resulting Jaspr code is printed directly to the console. You can then copy this code directly into your component's build method.
Selecting Specific Elements
If you only need a portion of the HTML, you MUST use the --query option with a CSS selector to target specific elements rather than converting the whole file and deleting pieces manually.
jaspr convert-html --file some/path/to/file.html --query "#my-id"
This will only convert and output the element with the id my-id.
Tip: To convert everything inside the <body> tag but exclude the <body> tag itself, use:
jaspr convert-html --file some/path/to/file.html --query "body > *"