https://jedlik-ts-template.herokuapp.com/ (Deploy menete: Deploy_on_Heroku.pdf)
- Node.js letöltése, telepítése:
https://nodejs.org/en/download/ - Git for windows telepítése
https://git-for-windows.github.io/ - Visual Studio Code - User Installer (továbbiakban VSCode) telepítése
https://code.visualstudio.com/Download - VSCode futtatása, Visual Studio Extensions telepítése: Ctrl-Shift-X
Kiterjesztés keresése, telepítés:
- "Add jsdoc comments" (opcionális)
- "Debugger for Chrome" (fontos, kell)
- "GitLens" (extra Git funkciók, opcionális a telepítése)
- "Markdown All in One" (opcionális)
- "TypeScript TSLint Plugin" (NEM a "TSLint (deprecated)" !!! ) (fontos, kell)
- "Spell Right" (helyesírás ellenőrzés) (opcionális)
- további kiterjesztések telepítése igény szerint
- Billentyűkombinációk beállítása:
File\Preferences\Keyboard Shortcuts menüvel, vagy Ctrl-K majd Ctrl-S
Parancs keresése: gépeléssel
Hozzárendelés, módosítás: "ceruza" ikonra kattintással, törlés: Del bill.
- gépel: "reopen" > parancs: "Reopen Closed Editor" > Remove Keybindings (vagy Del bill.)
- gépel: "test" > parancs: "Run Test Task" > hozzárendel: Ctrl-Shift-T
- gépel: "delete" > parancs: "Delete Line" > hozzárendel: Ctrl-L
- opcionális: további billentyűkombinációk hozzárendelése tetszés szerint
- A .vscode/settings.json állományban ("files.exclude" szekcióban) vezérelhető az
Explorer ablakban megjelenő állományok/mappák láthatósága - Opcionális: VSCode beállítása: lsd. az oldal végén
- https://github.com/nitslaszlo/JedlikTsTemplate.git
- Ha nem akarsz klónozni:
JedlikTsTemplate-master.zip letöltése, kicsomagolása a projekt szülőmappájába
Vagy: - Repo klónozása
Parancssor -> cd a projekt szülőmappája
"git clone https://github.com/nitslaszlo/JedlikTsTemplate.git"
Ha nem vagy társ-fejlesztő (contributor), akkor töröljed a .git mappát!
- Ha nem akarsz klónozni:
- JedlikTsTemplate mappa átnevezése tetszőlegesen, ha új projektet készítünk
Klónozott vagy átnevezett mappa helyi menüből: Open with Code,
vagy a VSCode indítása után File/Open Folder... menüpontba a project mappa megnyitása - VSCode terminál ablak aktiválása: View/Integrated Terminal menüvel, vagy Ctrl-ö
Node.js lokális modul(ok) telepítése:
terminál ablakból "npm i" parancs futtatása (@types/node modult telepíti, lsd.: package.json)
- VSCode indítása (utoljára megnyitott projektet visszatölti), vagy
Project mappa helyi menüből: Open with Code, vagy
VSCode indítása után File/Open Folder... menü pontba a project mappa megnyitása - Ctrl-Shift-B => TypeScript forrás átalakítása JavaScript-re
(app.ts => app.js, "npm run compile" parancsot futtatja)
(watch üzemmód, az első fordítás után már automatikus a fordítás)
(amig aktív a task, addig nem kell (lehet) újraindítani) - Ctrl-Shift-T => nodemon indítása
("npm run start" parancsot futtatja)
(amig aktív a task, addig nem kell (lehet) újraindítani)
(FONTOS!!! Olvasd el a 6. pontot!) - content.ts szerkesztése
- Futtatás: Chrome: http://localhost:8080/
A nodemon változás esetén csak a webszervert indítja újra, a böngészőt F5-el (böngészőben) kell frissíteni!
Nyomkövetés (beépített debugger és Chrome összekapcsolása):
VS Code-ban F5 -el (elhelyezett töréspontoknál megáll, változók vizsgálata) - Kilépésnél a Ctrl-Shift-T-vel indított nodemon szerver tovább fut!
Javasolt a terminál ablakban egy Ctrl-C-vel megszakítani a futását!
Ha ezt elfelejted, és nem indul (hibát jelez) újraindítás után a nodemon, akkor
futtasd az "npm run kill" parancsot a terminál ablakból.
- TypeScript: tsc -v
- Node.js: node -v
- git: git --version
- npm: npm -v
- telepített globális csomagok: npm -g ls --depth=0
- telepített lokális csomagok: npm ls --depth=0
- VSCode: Automatikus, balra lent a fogaskeréken jelzi, ha új verzió jön ki
- VSCode kiterjesztések: Automatikus, balra az Extensions ikon jelzi, ha új verzió jön ki
- TypeScript: npm update -g typescript
- Node.js: npm install --save-dev @types/node
- https://www.typescriptlang.org/docs/home.html
- https://www.tutorialspoint.com/typescript/
- https://www.typescriptlang.org/docs/handbook/basic-types.html
- https://code.visualstudio.com/docs
- https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf
- https://git-scm.com/book/en/v2
- https://heroku.com
- https://github.com/Microsoft/vscode-tips-and-tricks
- https://desoft.hu/downloads/git/git_v1.0.pdf
- GitHub account létrehozása:
https://github.com/
(nitslaszlo az account név a példában) - Git repository létrehozása:
pl.: GitHub asztali alkalmazással vagy github.com-on
(JedlikTsTemplate a repository neve a példában) - Git konfigurálása CMD vagy "Git CMD" ablakból:
- git config --global user.name nitslaszlo
- git config --global user.email [email protected]
- git config --global credential.helper wincred
- Visual Studio Code indítása - project betöltése
- Ha van klónozott projektben .Git (rejtett!!!) mappa, akkor törölni kell
- Git inicializálása a 3. ("Y") ikonnal vagy Ctrl-Shift-G
majd "Initialize Repository"-ra kattint (felül a rombusz ikonnal)
majd meg kell adni a projekt könyvtárát a git-nek - Remote repository megadása új terminál ablakból (Ctrl-Shift-ö), például:
- "git remote add origin https://github.com/nitslaszlo/JedlikTsTemplate.git"
(A pontos parancsot a repo létrehozásakor kiírja a GitHub)
- "git remote add origin https://github.com/nitslaszlo/JedlikTsTemplate.git"
- ".gitignore" fájl szerkesztése/létrehozása (ezek a mappák/állományok nem lesznek feltöltve):
Ctrl-N -el új fájl létrehozása vagy meglévő szerkesztése
A fájl tartalma:
node_modules
npm-debug.log
(További mappák és fájlok megadhatók, melyek nem kerülnek "feltöltésre")
Ctrl-S -> .gitignore néven menteni a projekt főkönyvtárába - Ctrl-Shift-G -> Commit message megadása felül, majd "commit" utasítás kiadása
Ctrl-Enter -el, vagy felül a "pipa" ikonnal - "There are no staged ..." kérdésre válaszolj "always"-el
- Változások szinkronizálása ("feltöltés")
Alul a státus sorban balra "Synchronize Changes" ikonra kattint
Első alkalommal a GitHub felhasználói nevet vagy e-mail címet és jelszót kér! - Változások szinkronizálása ("feltöltés")
Alul a státus sorban balra "Synchronize Changes" (felhő) ikonra kattint
Később fel- és letöltésnél egymást "kergető" nyilak lesznek. - A "Would you like Code to periodically run 'git fetch'?" kérdésére válaszoljunk "yes"-el
("git.autofetch": true lesz beállítva, alapértelmezésben 3 percenként ellenőrzi a változásokat)
- Ctrl-Shift-P vagy F1
- "Preferen..." gépelése
- Preferences: "Open Workplace Settings" a projektben tárolt beállításokhoz (ez az erősebb) vagy
Preferences: "Open User Settings" a felhasználónál tárolt beállításokhoz
Konfig fájl workspace: projekt/.vscode/settings.json
Konfig fájl user: c:/Users/UserName/AppData/Roaming/Code/User/settings.json