Articles

jsfiddle / togetherjs

Posted by admin

ce este TogetherJS?

TogetherJS este un serviciu pentru site-ul dvs. web care face surprinzător de ușor colaborarea în timp real.

folosind TogetherJS două persoane pot interacționa pe aceeași pagină, văzând cursoarele, editările și navigând împreună pe un site. Serviciul TogetherJS este inclus de proprietarul site-ului web, iar un site web poate personaliza și configura aspecte ale comportamentului TogetherJS pe site.

pentru mai multe informații și pentru a vedea împreună în acțiune, vizitați togetherjs.com

dacă doriți să integrați TogetherJS pe site-ul dvs., consultați wiki și începeți în mod special.

Contribuirea

restul acestui document este despre contribuția la TogetherJS – dar rapoarte, remedieri, caracteristici, etc. Uită-te înapoi la aceste alte link-uri, dacă sunteți în căutarea pentru altceva.

rapoarte de erori

vă rugăm să trimiteți rapoarte de erori ca probleme github. Nu vă faceți griji cu privire la etichete sau repere. Dacă utilizați feedback-ul în aplicație pentru a ne oferi un raport de eroare, este bine și el.

foaie de parcurs& planuri

pentru a vedea ce planificăm sau cel puțin având în vedere să facem cu TogetherJS, uita-te la a se vedea tracker nostru bug.

crearea unui mediu de dezvoltare

TogetherJS are două piese principale:

  • serverul, care echos mesaje înainte și înapoi între utilizatori. Serverul nu face prea mult, puteți privi istoria sa incredibil de plictisitoare.

  • clientul din togetherjs/ care face toată munca reală.

există un server hub TogetherJS implementat la https://hub.togetherjs.com – și nu este nevoie de alte implementări de server. Dacă doriți să încercați împreună, vă recomandăm să utilizați serverul nostru hub. Notă Dacă includeți TogetherJS pe un site https, trebuie să utilizați un server hub https.

fișierele trebuie să fie ușor „construite”: folosim mai puțin pentru stiluri și sunt generate câteva fișiere. Pentru a dezvolta aveți nevoie pentru a construi biblioteca folosind Grunt.

pentru a construi o copie a bibliotecii, a verifica afară TogetherJS:

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

apoi instalați npm și rulați:

$ npm install$ npm install -g grunt-cli

acest lucru va instala o grămadă de lucruri, dintre care majoritatea sunt folosite doar pentru dezvoltare. Singura dependență „server” este WebSocket-Node (și dacă utilizați hub-ul nostru, atunci nu trebuie să vă faceți griji cu privire la server). În mod implicit, totul este instalat local, adică în node_modules/. Acest lucru funcționează foarte bine, dar este util să instalați programul de linie de comandă grunt la nivel global, ceea ce npm install -g grunt-cli face.

acum Puteți construi Împreunăjs, cum ar fi:

$ grunt build buildsite --no-hardlink

aceasta va crea o copie a întregului site togetherjs.com în build/. Va trebui să configurați un server web local propriu indicat în directorul build/. Pentru a porni un server pe portul 8080, executați:

$ node devserver.js

dacă doriți să se dezvolte cu TogetherJS probabil doriți fișierele construite continuu. Pentru a face această utilizare:

$ grunt devwatch

acest lucru se va reconstrui atunci când sunt detectate modificări. Rețineți că Grunt este configurat să creeze legături dure în loc să copieze, astfel încât majoritatea modificărilor pe care le faceți fișierelor din togetherjs/ să nu fie nevoie să fie reconstruite pentru a apărea în build/togetherjs/. --no-hardlink dezactivează acest comportament.

puteți crea o copie statică a clientului TogetherJS pentru a o distribui și utiliza pe site-ul dvs. web. Pentru a face acest lucru a alerga:

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

apoi static-myapp/togetherjs.js și static-myapp/togetherjs-min.jsvor fi în loc, iar restul codului va fi sub static-myapp/togetherjs/. Le-ați implementa pe serverul dvs.

rularea unui server local

nu trebuie să rulați propria versiune a serverului hub. Dar dacă youappen pentru a face modificări la server, puteți schimba hubURL implicit prin setarea variabilei de mediu HUB_URL atunci când construiți. De exemplu:

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

testarea

testele sunt în togetherjs/tests/ — acestea sunt doctest.teste js. Pentru a rula efectiv testele construi împreunăjs, servi-l, și du-te la http://localhost:PORT/togetherjs/tests/ — de acolo testele sunt legate de la partea de sus a paginii. Testele reale sunt fișiere *.js în togetherjs/tests/, în general test_*.js pentru teste în stil unitate și func_*.js pentru teste funcționale.

link-ul „testare manuală” este ceva care vă permite să simulați diferite condiții în TogetherJS fără a configura un al doilea browser/client.

din păcate, nu există un alergător automat pentru aceste teste. Ar fi frumos dacă Karma ar putea fi configurat cu doctest.js în general, dar până acum nu se face.

Licență

Related Post

Leave A Comment