Articles

jsfiddle / togetherjs

Posted by admin

co je togetherjs?

TogetherJS je služba pro vaše webové stránky, která překvapivě usnadňuje spolupráci v reálném čase.

pomocí TogetherJS dva lidé mohou komunikovat na stejné stránce, vidět navzájem kurzory, úpravy, a procházení webu společně. Služba TogetherJS je zahrnuta vlastníkem webu, a web může přizpůsobit a nakonfigurovat aspekty chování togetherjs na webu.

pro více informací a vidět TogetherJS v akci, návštěva togetherjs.com

pokud chcete integrovat TogetherJS na své stránky, podívejte se na wiki a konkrétně začněte.

přispívající

zbytek tohoto dokumentu je o přispívání k TogetherJS – ale zprávy, opravy, funkce, atd. Podívejte se zpět na tyto další odkazy, Pokud hledáte něco jiného.

hlášení chyb

prosím odešlete hlášení chyb jako problémy s githubem. Nebojte se o štítky nebo milníky. Pokud použijete zpětnou vazbu v aplikaci, abyste nám poskytli hlášení o chybě, je to také v pořádku.

plán & plány

Chcete-li vidět, co plánujeme nebo alespoň zvažujeme dělat s TogetherJS, podívejte se na náš bug tracker.

nastavení vývojového prostředí

togetherjs má dva hlavní kusy:

  • server, který odráží zprávy tam a zpět mezi uživateli. Server toho moc nedělá, můžete se dívat na jeho neuvěřitelně nudnou historii.

  • klient v togetherjs/, který dělá veškerou skutečnou práci.

k dispozici je togetherjs hub server nasazen na https://hub.togetherjs.com – a tam je malá potřeba pro další nasazení serveru. Pokud si chcete vyzkoušet TogetherJS, doporučujeme použít náš hub server. Poznámka: pokud zahrnete TogetherJS na webu https, musíte použít server https hub.

soubory je třeba lehce „postavit“: pro styly používáme méně a vygeneruje se pár souborů. Chcete-li rozvíjet, musíte vytvořit knihovnu pomocí Grunt.

Chcete-li vytvořit kopii knihovny, Podívejte se na TogetherJS:

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

poté nainstalujte npm a spusťte:

$ npm install$ npm install -g grunt-cli

tím se nainstaluje spousta věcí, z nichž většina se používá pouze pro vývoj. Jedinou závislostí „serveru“ je WebSocket-Node (a pokud používáte náš rozbočovač, nemusíte se starat o server). Ve výchozím nastavení je vše nainstalováno lokálně, tj. Funguje to dobře, ale je užitečné nainstalovat program příkazového řádku grunt globálně, což npm install -g grunt-cli dělá.

nyní můžete stavět TogetherJS, jako:

$ grunt build buildsite --no-hardlink

tím se vytvoří kopie celého webu togetherjs.com v build/. Budete muset nastavit vlastní lokální webový server, který ukazuje na adresář build/. Chcete-li spustit server na portu 8080, spusťte:

$ node devserver.js

pokud se chcete vyvíjet s TogetherJS, pravděpodobně budete chtít soubory neustále vytvářet. K tomu použijte:

$ grunt devwatch

to bude znovu, když jsou zjištěny změny. Všimněte si, že Grunt je nakonfigurován tak, aby místo kopírování vytvářel pevné odkazy, takže většina změn, které provedete v souborech togetherjs/ ,nemusí být přestavěna, aby se zobrazila v build/togetherjs/. --no-hardlink toto chování vypne.

možná budete chtít vytvořit statickou kopii klienta TogetherJS, který bude distribuován a používán na vašem webu. Chcete-li tento běh:

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

pak budou na místě static-myapp/togetherjs.js a static-myapp/togetherjs-min.js a zbytek kódu bude pod static-myapp/togetherjs/. Ty byste nasadit na vašem serveru.

spuštění lokálního serveru

neměli byste spouštět vlastní verzi serveru hub. Pokud však chcete provést změny na serveru, můžete změnit výchozí hubURL nastavením proměnné prostředí HUB_URL při vytváření. Příklad:

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

testování

testy jsou v togetherjs/tests/ – jedná se o doctest.testy js. Chcete-li skutečně spustit testy, sestavte togetherjs, podávejte je a přejděte na http://localhost:PORT/togetherjs/tests/ – odtud jsou testy propojeny z horní části stránky. Skutečné testy jsou *.js soubory v togetherjs/tests/, obecně test_*.js pro testy jednotkového stylu a func_*.js pro funkční testy.

odkaz“ ruční testování “ je něco, co vám umožní simulovat různé podmínky v TogetherJS bez nastavení druhého prohlížeče/klienta.

pro tyto testy bohužel neexistuje žádný automatizovaný běžec. Mohlo by to být hezké, kdyby Karma mohla být nastavena pomocí doctestu.js obecně, ale zatím to není hotovo.

Licence

Related Post