Arbeitsumgebung · Famulus Notebook
Workbench · Famulus Notebook
Im Famulus Harness steht ein Notebook neben dem Gespräch mit Famulus. Das Notebook wird gelesen wie eine Veröffentlichung, am Ort bearbeitet und gerechnet; Famulus liest mit, schreibt auf Wunsch hinein und zeigt, was es geändert hat. Jede Aussage des Notebooks bleibt mit ihren Belegen verbunden.
In Famulus Harness a notebook stands beside the conversation with Famulus. The notebook reads like a publication, is edited in place and run; Famulus reads along, writes into it when asked and shows what it changed. Every statement of the notebook stays tied to its evidence.
Ein Notebook in Famulus ist ein Text mit Zellen: Jede Zelle stellt eine Frage an einen Bestand, wird gerechnet und an einer Erwartung geprüft. Das Harness ist der Ort, an dem ein solches Notebook im Gespräch entsteht.
A notebook in Famulus is a text with cells: each cell puts a question to a holding, is run and is checked against an expectation. The harness is the place where such a notebook is written in conversation.
Jede Sitzung hat ihr Notebook. Es öffnet sich neben dem Gespräch, sobald die Sitzung geöffnet wird oder Famulus ein Notebook liest oder anlegt. Was Famulus schreibt, erscheint ohne Neuladen.
Every session has its notebook. It opens beside the conversation when the session is opened or when Famulus reads or creates a notebook. What Famulus writes appears without a reload.
36 Werkzeuge für Notebooks und 6 für Famulus-Referenzen: lesen, Ergebnisse und Gründe ansehen, prüfen, schreiben, rechnen, zeigen. Vor jedem Schreiben und jedem Lauf fragt das Harness nach.
36 tools for notebooks and 6 for Famulus references: reading, looking at results and grounds, checking, writing, running, showing. Before every write and every run the harness asks.
Das Harness läuft als eigenes Programm mit eigenen Sitzungen und Einstellungen. Notebooks liegen als Dateien im Format .fam in Projektordnern; derselbe Notebook-Dienst bedient das Harness, den Browser und den Editor.
The harness runs as a program of its own, with its own sessions and settings. Notebooks are files in the format .fam in project folders; the same notebook service serves the harness, the browser and the editor.
Die Bibliothek zeigt alle Notebooks: die Hefte einer Reihe als Karten, dann die Projekte. Ein Notebook öffnet sich in der Form, in der eine Veröffentlichung gelesen wird.
The library shows all notebooks: the issues of a series as cards, then the projects. A notebook opens in the form in which a publication is read.
Ein Notebook wird an derselben Stelle bearbeitet, an der es gelesen wird, von Hand oder durch Famulus. Jedes Segment – Absatz, Tabelle, Abbildung, Zelle, Animation – hat einen Anker; ein Klick wählt es aus, mit „Mehrfach“ auch mehrere. Am Fuß des Notebooks steht dann das Feld der Operationen: Überarbeiten, Anmerken, Erläutern, Prüfen.
A notebook is edited at the place where it is read, by hand or by Famulus. Every segment – paragraph, table, figure, cell, animation – has one anchor; a click selects it, with "Mehrfach" several. The panel of operations then stands at the foot of the notebook: rework, annotate, explain, examine.
Ein Absatz, eine Tabelle, eine Bildunterschrift oder eine Zelle wird zu ihrem Quelltext und zeilengenau zurückgeschrieben. Nichts wird geschrieben, wenn die Datei inzwischen geändert wurde oder das Notebook danach nicht mehr lesbar wäre.
A paragraph, a table, a caption or a cell turns into its source text and is written back line by line. Nothing is written when the file has changed meanwhile or the notebook would no longer be readable.
Eine Anweisung in Worten genügt. Famulus setzt sie um, prüft das Ergebnis und baut es sofort in den Text ein; die Sitzung bleibt für die nächste Anweisung offen, bis übernommen oder abgebrochen wird. Ein Abbruch stellt den Zustand davor her, Byte für Byte. Fehlt der Anweisung etwas, ändert Famulus nichts und nennt, was fehlt.
An instruction in words suffices. Famulus carries it out, checks the result and builds it into the text at once; the session stays open for the next instruction until it is accepted or aborted. An abort restores the state before, byte for byte. When the instruction lacks something, Famulus changes nothing and names what is missing.
Fertig formulierte Anweisungen, nach Gruppen: die des Notebooks (Sprache, Kürzen, Präzisieren, für Nicht-Fachleute, Frage schärfen) und die des Lektors (Revision, Sprache, Terminologie, Argument, Apparat). Eigene Worte ergänzen eine Vorgabe. Was sie zu erhalten verspricht – Verweise, Zitate, Zahlen, Formeln –, wird am Ergebnis geprüft.
Instructions that are already worded, by group: the notebook's own (language, shorten, make precise, for non-specialists, sharpen the question) and the Lektor's (revision, language, terminology, argument, apparatus). The author's own words add to a preset. What it promises to keep – references, citations, numbers, formulas – is checked on the result.
Was ein Segment aus dem Paket astra zeigt, lässt sich per Anweisung ändern: eine Sichtlinie, eine in Stufen kommentierte Animation. Das Paket bleibt unberührt; es entsteht ein eigener Text des Projekts. Ebenso entsteht ein neues Modell mit Überlagerung, Werten und Abbildung – jeder Text vom Prüfer der Sprache geprüft, bevor er erscheint. Für ein Modell ohne Beleg schreibt Famulus nichts und fragt nach der Stelle.
What a segment shows from the package astra can be changed by an instruction: a line of sight, an animation commented in stages. The package stays untouched; a text of the project's own arises. A new model with its superposition, values and figure arises in the same way – every text checked by the language's checker before it appears. For a model without a witness Famulus writes nothing and asks for the passage.
Ein Projekt nennt in seiner Projektdatei, was es von außen nutzt: Notebooks anderer Projekte, Hefte der Reihe Famulus Expertise und Pakete von Famulus-Experten, etwa fr:astra/solar. Genau das steht ihm zur Verfügung; alles andere ist eine benannte Lücke. Ändert sich ein importierter Text, gelten die Segmente, die auf ihm beruhen, als veraltet, bis der neue Stand bestätigt ist.
A project names in its project file what it uses from elsewhere: notebooks of other projects, issues of the series Famulus Expertise and packages of Famulus experts, for instance fr:astra/solar. Exactly that is available to it; everything else is a named gap. When an imported text changes, the segments resting on it count as stale until the new state is confirmed.
Famulus ändert eine Stelle wörtlich, schreibt Zellen und Abschnitte, legt Notebooks an und fügt Referenzen ein. Jede Änderung wird vorher in einem Satz genannt und erst nach Zustimmung ausgeführt.
Famulus changes a passage word by word, writes cells and sections, creates notebooks and inserts references. Every change is named in one sentence beforehand and carried out only after consent.
Zellen laufen einzeln oder alle veralteten zusammen, Erzeuger zuerst. Jede Zelle zeigt ihren Stand: bestanden, abweichend, Lücke oder Fehler. Zu einer Antwort lassen sich die Gründe als Baum öffnen. Zellen rechnen auch mit importierten Modellen: die Schritte einer Herleitung, die Prüfstufen der Texte, die Örter zweier Punkte über einen Umlauf, je als Tabelle mit Messwerten.
Cells run one by one or all stale ones together, producers first. Every cell shows its state: passed, deviating, gap or error. The grounds of an answer open as a tree. Cells also compute with imported models: the steps of a derivation, the levels the texts reach, the places of two points over a revolution, each as a table with counted values.
Jeder Stand eines Notebooks wird festgehalten, wer auch immer geschrieben hat: die Hand, Famulus, eine übernommene Fassung, ein Programm außerhalb. Zu jedem Absatz gibt es den Verlauf; jede Änderung lässt sich zurücknehmen, und die Rücknahme ist selbst ein Stand.
Every state of a notebook is kept, whoever wrote it: the hand, Famulus, an accepted revision, a program outside. Every paragraph has its history; every change can be taken back, and the take-back is itself a state.
/notebook wählt das Notebook der Sitzung, /status zeigt den Stand der Zellen, /run rechnet, /gruende zeigt die Begründung einer Zelle. /anweisung und /vorgabe geben einem Segment eine Anweisung, /zurueck, /uebernehmen und /abbrechen führen die Sitzung, /importe zeigt die Importe. Die Antwort steht im Notebook-Fenster.
/notebook chooses the session's notebook, /status shows the state of the cells, /run runs, /gruende shows the justification of a cell. /anweisung and /vorgabe give a segment an instruction, /zurueck, /uebernehmen and /abbrechen lead the session, /importe shows the imports. The answer stands in the notebook pane.
Eine markierte Stelle des Notebooks geht mit einem Klick als Zitat in das Gespräch mit Famulus.
A marked passage of the notebook goes into the conversation with Famulus as a quotation with one click.
Famulus Expertise ist die Publikationsreihe der Famulus-Editionen. Jedes Heft ist ein Notebook: Es nennt seine Quellen mit Adresse, seine Behauptungen und deren Belege.
Famulus Expertise is the publication series of the Famulus editions. Every issue is a notebook: it names its sources by address, its claims and their evidence.
Die Reihe Famulus ExpertiseThe series Famulus ExpertiseHeft Astra 1: Geometrical Reasoning in the History of AstronomyIssue Astra 1: Geometrical Reasoning in the History of AstronomyHeft Euler 1: Euler's Argument for the Tide-Raising ForceIssue Euler 1: Euler's Argument for the Tide-Raising ForceHeft Kepler 1: Reconstructing Kepler's Reasoning in the Astronomia NovaIssue Kepler 1: Reconstructing Kepler's Reasoning in the Astronomia Nova
Was ein Notebook behauptet, steht nicht für sich. Es verweist auf adressierte Objekte, und es ist selbst adressierbar.
What a notebook states does not stand alone. It refers to addressed objects, and it is addressable itself.
fr:kepler-prim/kgw-03/0071/p05Ein Absatz einer Quelle. Jeder Satz, jeder Absatz, jede Abbildung, jede Seite eines Bestands hat eine solche Adresse; im Notebook erscheint sie als Karte mit Wortlaut und Zitierform.
A paragraph of a source. Every sentence, paragraph, figure and page of a holding has such an address; in the notebook it appears as a card with wording and citation.
fr:astra/kepler-equant-unequal-motionEin Objekt eines Famulus-Experten, hier eine Herleitung aus der Astronomie. Im Notebook wird daraus ein Argument Schritt für Schritt; ein Modell wird zur Animation.
An object of a Famulus expert, here a derivation from astronomy. In the notebook it becomes an argument step by step; a model becomes an animation.
fam:projekt/notebook/zelle.artefaktDas Ergebnis einer Zelle, auch in einem anderen Notebook oder Projekt. Wer darauf verweist, rechnet mit dem Ergebnis weiter. Folgt der Verweis dem jeweils neuesten Stand, gilt die lesende Zelle als veraltet, sobald der Erzeuger neu gerechnet hat.
The result of a cell, also in another notebook or project. A cell that refers to it computes on with the result. When the reference follows the latest state, the reading cell counts as stale as soon as the producer has run again.
fr:notebook/projekt/notebookEin Notebook selbst, eine seiner Zellen oder ein Ergebnis, in der allgemeinen Adressordnung famulus-ref/2. Die Adresse löst der Referenzpunkt auf, der das Notebook hält.
A notebook itself, one of its cells or a result, in the general address order famulus-ref/2. The address is resolved by the reference point that holds the notebook.
fr:expertise/astra/1Ein veröffentlichtes Heft der Reihe Famulus Expertise, mit Zusammenfassung, Zitierform und maschinenlesbarer Beschreibung.
A published issue of the series Famulus Expertise, with abstract, citation and a machine-readable description.
Famulus sucht, löst auf, beschreibt und zitiert solche Adressen mit eigenen Werkzeugen und fügt sie in das Notebook ein. Eine Adresse, die sich nicht auflösen lässt, wird als Lücke gezeigt, nie als Beleg.
Famulus searches, resolves, describes and cites such addresses with tools of its own and inserts them into the notebook. An address that cannot be resolved is shown as a gap, never as evidence.
Das Harness ist eine Oberfläche für Famulus Notebook. Was ein Notebook kann, beschreibt dessen Dokumentation.
The harness is a surface for Famulus Notebook. What a notebook can do is described in its documentation.
Famulus Harness. A Notebook Beside a Conversation: Instruction Sessions, Imported Models and Checked Changes (Entwurf vom 11. November 2026, PDF, englisch)Famulus Harness. A Notebook Beside a Conversation: Instruction Sessions, Imported Models and Checked Changes (draft of 11 November 2026, PDF)
Ausblick
Outlook
Das World Wide Web hat Dokumente verbunden. Jede Seite bekam eine Adresse, und jede Seite konnte auf jede andere verweisen. Famulus überträgt diesen Gedanken von Dokumenten auf Wissen.
The World Wide Web connected documents. Every page was given an address, and every page could refer to every other. Famulus carries this thought over from documents to knowledge.
Jeder Satz einer Quelle, jede Abbildung, jeder Registereintrag, jedes Heft und jedes Notebook hat eine Adresse. Ein Notebook, das auf solche Adressen verweist, legt offen, worauf seine Aussagen ruhen. Es wird damit selbst zu einem Bestand, auf den andere Notebooks verweisen. Verbunden sind dann nicht Seiten, sondern Aussagen mit ihren Begründungen.
Every sentence of a source, every figure, every register entry, every issue and every notebook has an address. A notebook that refers to such addresses lays open what its statements rest on. It thereby becomes a holding itself, to which other notebooks refer. What is connected then is not pages but statements with their justifications.
Die Bestände eines solchen Netzes sind fehlbar. Verlässlich werden sie nicht durch eine Stelle, die sie für wahr erklärt, sondern dadurch, dass ihre Gründe offenliegen und der Kritik der wissenschaftlichen Gemeinschaft ausgesetzt bleiben. Ein Einwand, der überzeugt, steht in der nächsten Version; fällt ein Beleg, so ist benannt, welche Aussagen ihre Rechtfertigung verlieren.
The holdings of such a network are fallible. They become reliable not through an authority that declares them true, but because their grounds lie open and remain exposed to the criticism of the scientific community. An objection that convinces stands in the next version; when a piece of evidence falls, it is named which statements lose their justification.
Ein Zentrum braucht dieses Netz nicht. Wer Wissen beiträgt, veröffentlicht es unter eigener Adresse in einem eigenen Register; wer es nutzt, verweist darauf. Das Web ist gewachsen, weil ein Verweis eine Zeile kostete. Im WWK kostet der Verweis auf einen Beleg ebenfalls eine Zeile.
This network needs no centre. Whoever contributes knowledge publishes it under an address of their own in a register of their own; whoever uses it refers to it. The Web grew because a reference cost one line. In the WWK the reference to a piece of evidence costs one line as well.
Dies ist ein Ausblick, kein Bericht über einen erreichten Stand. Heute lösen die Referenzpunkte des Vorhabens ihre Adressen auf; ein weltweites Netz fremder Referenzpunkte besteht noch nicht.
This is an outlook, not a report on a state reached. Today the reference points of the project resolve their addresses; a worldwide network of other reference points does not exist yet.
Famulus – vom WWW zum WWK. Kurzfassung für Einrichtungen (PDF, 2 Seiten)Famulus – from the WWW to the WWK. A short account for institutions (PDF, 2 pages)
Stand vom 12. November 2026.As of 12 November 2026.
Herausgegeben von der OpenScienceTechnology GmbH · Impressum · Datenschutz
