Skip to the text
Parseh
پParseh guide The studio›A page for a website
On this page

A page for a website

A PDF reaches a reader on paper. Download ▾ → HTML page, for a website (.html) reaches one on a screen who has no Parseh: a student who opens a link on your class’s website. It is one file. Put it on a website, send it, or open it straight from the disk: it works with no server of any kind behind it. Its exercises can be answered and checked, its recordings play, its pictures are there. Everything it shows travels inside the file.

1. Making one#

On the document’s page, open Download ▾ and choose HTML page, for a website (.html), right under PDF. The file comes after a moment, named after the document: verbs-of-motion.html for /studio/doc/verbs-of-motion-3f9a1c. Nothing has to be built first, and the document itself is not touched.

Making the page can take a while on a long document, or from a phone reaching your computer over a slow link. Until the file comes, a bar under the page’s header says what Parseh is making and counts the seconds, and the page stays where it is: you can go on reading. If the file cannot come — Parseh does not answer, or says why it could not make it — the bar says so, with Try again.

The page is made from the document as it is saved: save in the editor first.

A deck’s exercises can be a page too, one that crams them: see Cram mode.

2. What the page has#

The document as it reads.
The same sheet as its page in the studio, with its colours, numbered sections, lemma headings, boxes, tables and formulas. A footnote’s number shows the note in a cloud when you hover over it or tap it.
Its exercises, working.
Every exercise can be answered, and Check exercises at the end marks them all and gives the score, as on the studio’s page. Flashcards turn when you click them, their 🔊 plays, ⤢ Enlarge opens one large, and Hide transliterations works.
Its pictures and recordings, inside the file.
Where a recording is played only in part (start=0 end=0.4), that stretch is cut out when the file is made, as long as ffmpeg is installed on your computer (Installing). A page that plays one word of a long recording then carries only that word. Without ffmpeg the whole recording goes in, once, and the page plays its stretch of it.
A video, in YouTube’s own player.
It is the one thing the page reaches out for. It needs the internet, and it plays only when the page is on a website: opened from the disk, YouTube refuses it with Video player configuration error. A player has to tell YouTube which site it is on, and a file on the disk is on no site. So there, and only there, a line under the video says so: YouTube plays this video only when the page is on a website — watch it on YouTube, the last words opening the video on YouTube, from where the page’s stretch of it begins.
The linguistic cloud.
Pointing at a word of the target language — including any coloured part of a partially coloured word — opens one cloud for the complete word: its transliteration and the kana of a Japanese word. It has no colour controls. A pronunciation or reading changed there is changed on the open page only, and is gone when the tab is closed or reloaded. The first time a word or the cloud is clicked (or tapped, on a phone), a line over the screen says so once: Changes made here are not saved. It stays a few seconds, takes no click of its own, and does not come back until the page is opened again.
Its LaTeX drawings
, inside the file as pictures (LaTeX drawings); one that could not be made stands as its frame, and the studio says how many.
Contents.
At the top, when the document has sections: a list that opens and shuts, whose entries jump to their section.
Glosses.
Under the contents: the document’s glosses as a table that opens and shuts, with a box that filters them as you type. The studio’s flashcard drill of the glosses is not on the page.
Aa.
At the top right: the size of the text and the theme, Paper, Sepia or Dark. The page starts on Sepia, the warm paper made for reading, whatever the studio was showing when you made it and whatever the student’s computer or phone prefers; a student who likes another picks it here, until the tab is closed.
Its foot.
This page was exported from Parseh, with links to Parseh on GitHub and to Parseh’s guide, this one. Each opens in a new tab, so the page, and every answer given on it, stays as it was.

3. What it leaves out#

The page is read-only by construction. A student can answer it, never change it.

No Markdown.
What goes in is the typeset page, never its source: not the Markdown of a target-language run, not a line number, nothing the editor finds a line by. The document’s Markdown can be neither read nor pieced back together from the file.
Nothing that edits.
There is no ✎, no ⚙ on a picture or a player, no + Deck, no colour picker, and none of the code behind them is in the file. The cloud’s pronunciation or reading changes the open page and nothing else. Colours embedded by the author, including colours within a word, are preserved but cannot be edited there.
No word about decks.
A flashcard set to Both (repeat) does not say, as it does in the studio, that a deck will ask both sides: nothing on the page goes into a deck.
No links to your other documents.
A link to another document of the library ([…](doc:Name)) keeps its words and loses the link, and the other document’s name goes with it: that document is not on the website. Links to web pages stay links.
No technical note, no print button.
The Nota tecnica at the end of the studio’s page is left off. The browser’s own Print prints the page without its bar, its panels and the Aa menu, and the links of its foot print with their addresses.

4. It keeps nothing#

The page keeps nothing and sends nothing. The size and theme chosen with Aa, the answers given, the transliterations hidden, what was changed in the linguistic cloud: all of it lasts until the tab is closed or reloaded, and none of it is written anywhere. Nothing goes into the browser’s storage or a cookie, and nothing to any server. The page tells the browser so itself: its own security rules forbid it to send anything, or to fetch anything but a YouTube player. So the rules hold on a website you do not run, too. A link a student follows from the page does not say where it was followed from, and the YouTube player is told the site’s address and nothing more.

The answers are in the file, as they are in the studio’s page: a page that marks answers has to know them. A student who reads the file’s source can find them. A page on a website is for practice, not for an exam.

5. How big it is#

About half a megabyte for a short note: the page’s styles, the script its exercises need, and the faces it is set in, cut down to the letters the page uses. Its pictures and recordings add their own size. A formula anywhere adds about 2 MB, because the first formula brings MathJax whole, the typesetter that draws formulas. A page without formulas carries none of it.