Charticulator ist ein neues Diagrammtool, mit dem Sie Diagramme durch interaktive Angabe von Einschränkungen entwerfen können.
Befolgen Sie die folgenden Schritte, um eine Entwicklungsumgebung vorzubereiten:
Knotenmodule installieren:
yarn
Kopieren Sie die Vorlagenkonfigurationsdatei und bearbeiten Sie ihren Inhalt:
cp config.template.yml config.yml
# (on windows, use copy instead of cp)
Führen Sie den folgenden Befehl aus, um Charticulator zu erstellen, wodurch ein eigenständiges Paket im dist
-Ordner erstellt wird:
yarn build
Führen Sie einen lokalen Webserver aus, um Charticulator zu testen:
# Serve Charticulator at http://localhost:4000
yarn server
# Serve Charticulator publicly at http://0.0.0.0:4000
# Use this if you want to enable access from another computer
yarn public_server
Lassen Sie für eine Live-Entwicklungsumgebung den folgenden Befehl laufen:
yarn start
Dieser Befehl überwacht alle Änderungen in src/
und sass/
und kompiliert Charticulator automatisch neu. Öffnen Sie anschließend http://localhost:4000/, um Charticulator zu starten. Wenn Sie nun den Quellcode ändern, kann die App aktualisiert werden, indem Sie einfach die Browserseite aktualisieren (möglicherweise müssen Sie den Browser-Cache deaktivieren).
Im Entwicklungsmodus gibt es eine Testanwendung für UI-Komponenten, die unter http://localhost:4000/test.html aufgerufen werden kann.
Der Überwachungsmodus wird nicht aktualisiert, wenn Sie Folgendes ändern:
Wenn Sie diese aktualisieren, führen Sie bitte yarn build
erneut durch.
Sie können benutzerdefinierte Beispieldatensätze hinzufügen, die mit Charticulator verwendet werden können. Erstellen Sie dazu einen datasets
im Stammverzeichnis des Repositorys (sofern dieser nicht vorhanden ist), fügen Sie Ihre .csv
(oder .tsv
) zu diesem Ordner hinzu und erstellen Sie schließlich eine files.json
Datei im Ordner mit Folgendem Inhalt:
[
{
"name": "",
"description": "",
"tables": [
{
"name": "",
"type": "",
"url": ""
}
]
}
]
Charticulator enthält derzeit einen rudimentären Testcode:
yarn test
Weitere Testfälle sind erforderlich.
Dieses Projekt freut sich über Beiträge und Vorschläge. Für die meisten Beiträge müssen Sie einem Contributor License Agreement (CLA) zustimmen, in dem Sie erklären, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dies auch tatsächlich tun. Weitere Informationen finden Sie unter https://cla.microsoft.com.
Wenn Sie eine Pull-Anfrage einreichen, ermittelt ein CLA-Bot automatisch, ob Sie eine CLA bereitstellen und die PR entsprechend dekorieren müssen (z. B. Beschriftung, Kommentar). Folgen Sie einfach den Anweisungen des Bots. Sie müssen dies nur einmal für alle Repos tun, die unsere CLA verwenden.
Dieses Projekt hat den Microsoft Open Source Verhaltenskodex übernommen. Weitere Informationen finden Sie in den FAQ zum Verhaltenskodex oder wenden Sie sich bei weiteren Fragen oder Kommentaren an [email protected].
Führen Sie yarn typedoc
aus, um Dokumentationsseiten zu generieren. Die Seite wird unter ./docs/charticulator
verfügbar sein
Ausgangspunkt der Dokumentation ist die Indexseite {@link „index“}