Articles

jsfiddle / togetherjs

Posted by admin

Hva Er TogetherJS?

TogetherJS er en tjeneste for nettstedet ditt som gjør det overraskende enkelt å samarbeide i sanntid.

ved Hjelp Av TogetherJS kan to personer samhandle på samme side, se hverandres pekere, redigeringer og surfe på et nettsted sammen. Tjenesten Er inkludert av eieren av nettstedet, og et nettsted kan tilpasse og konfigurere aspekter av Selskapets oppførsel på nettstedet.

For mer informasjon og For Å se TogetherJS i aksjon, besøk togetherjs.com

hvis Du ønsker å integrere TogetherJS på nettstedet ditt se wiki og Spesielt Komme i Gang.

Bidra

resten av dette dokumentet handler om å bidra Til TogetherJS – men rapporter, feilrettinger, funksjoner, etc. Se tilbake på de andre linkene hvis du er ute etter noe annet.

Feilrapporter

vennligst send feilrapporter som github-problemer. Ikke bekymre deg for etiketter eller milepæler. Hvis du bruker tilbakemeldingen i appen for å gi oss en feilrapport, er det også bra.

Veikart & Planer

For å se hva vi planlegger eller i det minste vurderer å gjøre Med TogetherJS, se på se vår bug tracker.

Sette opp et utviklingsmiljø

TogetherJS har to hoveddeler:

  • serveren, som ekko meldinger frem og tilbake mellom brukere. Serveren gjør ikke mye, du kan stirre på sin utrolig kjedelige historie.

  • klienten i togetherjs/ som gjør alt det virkelige arbeidet.

Det er En TogetherJS hub server distribuert på https://hub.togetherjs.com – og det er lite behov for andre server distribusjoner. Hvis du ønsker Å prøve TogetherJS ut anbefaler vi at du bruker vår hub server. Hvis Du inkluderer TogetherJS på et https-område, må du bruke en https hub-server.

filene må være lett «bygget»: vi bruker MINDRE for stiler, og et par filer genereres. For å utvikle må du bygge biblioteket ved Hjelp Av Grunt.

for å bygge en kopi av biblioteket, sjekk Ut TogetherJS:

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

deretter installerer du npm og kjører:

$ npm install$ npm install -g grunt-cli

Dette vil installere en haug med ting, hvorav de fleste bare brukes til utvikling. Den eneste «server» avhengighet Er WebSocket-Node (og hvis du bruker vår hub så trenger du ikke å bekymre deg for serveren). Som standard er alt installert lokalt, dvs. i node_modules/. Dette fungerer fint, men det er nyttig å installere kommandolinjeprogrammet grunt globalt, som npm install -g grunt-cli gjør.

Nå kan du bygge TogetherJS, som:

$ grunt build buildsite --no-hardlink

Dette vil skape en kopi av hele togetherjs.com – området i build/. Du må sette opp en lokal webserver av din egen pekte på katalogen build/. For å starte en server på port 8080, kjør:

$ node devserver.js

hvis Du vil utvikle Med TogetherJS, vil du sannsynligvis at filene bygges kontinuerlig. For å gjøre dette bruk:

$ grunt devwatch

dette vil gjenoppbygge når endringer oppdages. Vær oppmerksom På At Grunt er konfigurert til å opprette harde koblinger i stedet for å kopiere, slik at de fleste endringer du gjør i filer i togetherjs/ ikke trenger å bygges for å vises i build/togetherjs/. --no-hardlink slår av denne virkemåten.

det kan være lurt å lage en statisk kopi Av TogetherJS klienten til å distribuere og bruke på nettstedet ditt. For å gjøre dette løp:

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

da vil static-myapp/togetherjs.js og static-myapp/togetherjs-min.js være på plass, og resten av koden vil være under static-myapp/togetherjs/. Du vil distribuere disse på serveren din.

Kjører en lokal server

du trenger ikke å kjøre din egen versjon av hub-serveren. Men hvis du skal gjøre endringer på serveren, kan du endre standard hubURL ved å sette HUB_URL miljøvariabelen når du bygger. Eksempelvis:

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

Testing

Tester er i togetherjs/tests/ – disse er doctest.js tester. Å faktisk kjøre testene bygge togetherjs, tjene den opp, og gå til http://localhost:PORT/togetherjs/tests/ – derfra testene er knyttet til fra toppen av siden. De faktiske testene er *.js filer i togetherjs/tests/, generelt test_*.js for enhetstester, og func_*.js for funksjonstester.

Koblingen «Manuell testing» er noe som lar deg simulere forskjellige forhold I TogetherJS uten å sette opp en annen nettleser/klient.

det er dessverre ingen automatisert løper for disse testene. Det kan være fint Om Karma kunne settes opp med doctest.js generelt, men så langt er det ikke gjort.

Lisens

Related Post

Leave A Comment