Articles

jsfiddle / togetherjs

Posted by admin

Wat is TogetherJS?

TogetherJS is een service voor uw website die het verrassend eenvoudig maakt om in real-time samen te werken.

met behulp van TogetherJS kunnen twee mensen op dezelfde pagina communiceren, elkaars cursors, bewerkingen en samen een site bekijken. De TogetherJS-service is opgenomen door de website-eigenaar, en een website kan aspecten van het gedrag van TogetherJS op de site aanpassen en configureren.

voor meer informatie en om samen te zien js in actie, bezoek togetherjs.com

als je TogetherJS wilt integreren op je site, zie de wiki en specifiek aan de slag gaan.

bijdragen

de rest van dit document gaat over bijdragen aan gezamenlijke js – maar rapporten, fixes, functies, enz. Kijk terug op die andere links als u op zoek bent naar iets anders.

bugrapporten

stuur bugrapporten als github-problemen. Maak je geen zorgen over labels of mijlpalen. Als je de In-app feedback gebruikt om ons een bugrapport te geven, is dat ook prima.

Roadmap & plannen

om te zien wat we van plan zijn of op zijn minst overwegen om te doen met TogetherJS, kijk naar onze bug tracker.

een ontwikkelomgeving opzetten

TogetherJS heeft twee hoofdelementen:

  • de server, die berichten echos heen en weer tussen gebruikers. De server niet veel doen, kunt u blik op zijn ongelooflijk saaie geschiedenis.

  • de client in togetherjs/ die al het echte werk doet.

er is een TogetherJS hub server geà mplementeerd op https://hub.togetherjs.com – en er is weinig behoefte aan andere serverimplementaties. Als u wilt proberen TogetherJS uit raden wij u gebruik maken van onze hub server. Opmerking Als u TogetherJS op een HTTPS-site opneemt, moet u een HTTPS-hub-server gebruiken.

de bestanden moeten licht “gebouwd” zijn: we gebruiken minder voor stijlen, en er worden een paar bestanden gegenereerd. Om te ontwikkelen moet je de bibliotheek te bouwen met behulp van Grunt.

om een kopie van de bibliotheek te maken, ga naar TogetherJS:

$ git clone git://github.com/mozilla/togetherjs.git$ cd togetherjs

installeer vervolgens npm en voer uit:

$ npm install$ npm install -g grunt-cli

dit zal een heleboel dingen installeren, waarvan de meeste alleen worden gebruikt voor ontwikkeling. De enige” server ” afhankelijkheid is WebSocket-Node (en als u onze hub gebruikt dan hoeft u zich geen zorgen te maken over de server). Standaard wordt alles lokaal geïnstalleerd, dus in node_modules/. Dit werkt prima, maar het is handig om het opdrachtregelprogramma grunt globaal te installeren, wat npm install -g grunt-cli wel doet.

nu kunt u samen js bouwen, zoals:

$ grunt build buildsite --no-hardlink

dit maakt een kopie van de gehele togetherjs.com site in build/. U moet een eigen lokale webserver instellen die naar de build/ map wijst. Om een server op poort 8080 te starten, voer je uit:

$ node devserver.js

Als u wilt ontwikkelen met TogetherJS u waarschijnlijk wilt dat de bestanden gebouwd voortdurend. Om dit te doen gebruik:

$ grunt devwatch

dit zal opnieuw worden opgebouwd wanneer wijzigingen worden gedetecteerd. Merk op dat Grunt is geconfigureerd om harde links te maken in plaats van te kopiëren, zodat de meeste wijzigingen die u aanbrengt in bestanden in togetherjs/ niet opnieuw hoeven te worden gemaakt om te verschijnen in build/togetherjs/. --no-hardlink schakelt dit gedrag uit.

u kunt een statische kopie maken van de TogetherJS-client om te distribueren en te gebruiken op uw website. Om deze run te doen:

$ grunt build --base-url https://myapp.com --no-hardlink --dest static-myapp

dan zijn static-myapp/togetherjs.js en static-myapp/togetherjs-min.js aanwezig, en de rest van de code staat onder static-myapp/togetherjs/. Je zou deze op je server zetten.

een lokale server draaien

u hoeft niet uw eigen versie van de hub-server te draaien. Maar als u wijzigingen wilt aanbrengen aan de server, kunt u de standaard hubURL wijzigen door de HUB_URL omgevingsvariabele in te stellen tijdens het bouwen. Bijvoorbeeld:

$ HUB_URL=http://localhost:8080 grunt devwatch

testen

testen zijn in togetherjs/tests/ — deze zijn doctest.js testen. Om de test build togetherjs daadwerkelijk uit te voeren, dien het op, en ga naar http://localhost:PORT/togetherjs/tests/ — van daaruit worden de tests gekoppeld vanaf de bovenkant van de pagina. De werkelijke tests zijn *.js bestanden in togetherjs/tests/, meestal test_*.js voor eenheidstests, en func_*.js voor functionele tests.

de link “handmatig testen” is iets waarmee u verschillende voorwaarden kunt simuleren in TogetherJS zonder een tweede browser/client in te stellen.

er is helaas geen automatische loper voor deze tests. Het zou leuk zijn als Karma met doctest kon worden opgezet.js in het algemeen, maar tot nu toe is dat niet gedaan.

Vergunning

Related Post

Leave A Comment