diff options
1 files changed, 53 insertions, 50 deletions
| -rw-r--r-- | src/teaching/upp-2023/week1/setup.du | 103 |
diff --git a/src/teaching/upp-2023/week1/setup.du b/src/teaching/upp-2023/week1/setup.du index 6b22df6..e1d2f30 100644 --- a/src/teaching/upp-2023/week1/setup.du +++ b/src/teaching/upp-2023/week1/setup.du @@ -1,8 +1,11 @@ -# Конфигуриране на GitHub classroom и Visual Studio - УПП, Седмица 1, 06.10.2023 +'def title Конфигуриране на GitHub classroom и Visual Studio - УПП, Седмица 1, 06.10.2023 +'def desc Постъпково упътване към настройване на всичко нужно за практикума + +# {title} \n -[$presentation-controller] +{presentation-controller} :title_slide @@ -30,20 +33,20 @@ ### Git -[$br1] +{br1} .p -git е програма (система) за [url https://en.wikipedia.org/wiki/Distributed_version_control контрол на версиите]. -В един проект, git пази [=списък от всички commit-и=]. -Един commit в себе си [=съдържа какви са точно промените=], кой ги е направил, кога са направени, защо са направени и так. нат. -Този списък, заедно с още неща за които не е нужно да мислите, се нарича [=repository=]. +git е програма (система) за {url контрол на версиите;https://en.wikipedia.org/wiki/Distributed_version_control}. +В един проект, git пази {b списък от всички commit-и}. +Един commit в себе си {b съдържа какви са точно промените}, кой ги е направил, кога са направени, защо са направени и так. нат. +Този списък, заедно с още неща за които не е нужно да мислите, се нарича {b repository}. .p -Обаче, [=commit-ове не се правят автоматично=], не е като историята с промени в един Word файл. -[=Commit се прави от разработчика=], и то за предпочитане на всеки няколко (свързани) промени. +Обаче, {b commit-ове не се правят автоматично}, не е като историята с промени в един Word файл. +{b Commit се прави от разработчика}, и то за предпочитане на всеки няколко (свързани) промени. .p -Така, когато смесваме кода от многото разработчици, ще можем да засечем [=какви точно са различията=] между работата на двама човека.\n +Така, когато смесваме кода от многото разработчици, ще можем да засечем {b какви точно са различията} между работата на двама човека.\n Често промените не си "противоречат" и могат да бъдат смесени директно, понякога се налага ръчно да решим какво точно да се случи с тези парчета код. @@ -51,11 +54,11 @@ git е програма (система) за [url https://en.wikipedia.org/wiki ### GitHub -[$br5] +{br5} .p Всички repository-та трябва да се пазят някъде и да може лесно да се споделят и гледат. -Има много сайтове за тази цел, най-популярния се нарича [url https://github.com GitHub]. +Има много сайтове за тази цел, най-популярния се нарича {url GitHub;https://github.com}. .p Напомням, че git и GitHub са напълно отделни неща, направени от различни хора с различни функционалности. @@ -67,9 +70,9 @@ git е програма (система) за [url https://en.wikipedia.org/wiki ## Сега всички трябва да си направят GitHub акаунти .p -Отивате на [url https://github.com/signup github.com/signup], въвеждате си данните една по една и се регистрирате +Отивате на {url github.com/signup;https://github.com/signup}, въвеждате си данните една по една и се регистрирате -.p [image ./img/github-signup.gif] +.p {img ./img/github-signup.gif} :middle_slide @@ -77,7 +80,7 @@ git е програма (система) за [url https://en.wikipedia.org/wiki .p След това, като влезете в акаунтите си (което става автоматично след регистрация), на заглавната страница ще имате нещо такова: -.width75% [image ./img/github-index.gif] +.width75% {img ./img/github-index.gif} .p В горния десен ъгъл, където е иконката с квадрати на бял фон, след натискане получавате sidebar. @@ -94,24 +97,24 @@ git е програма (система) за [url https://en.wikipedia.org/wiki .p Най-простия начин, който намерих, е да отворите -[url https://support.github.com/contact/reinstatement support.github.com/contact/reinstatement]\n +{url support.github.com/contact/reinstatement;https://support.github.com/contact/reinstatement}\n Ако отгоре пише "Your account has been flagged", тогава имаме проблем. .p -[image ./img/github-support-flagged.gif] +{img ./img/github-support-flagged.gif} :slide ## GitHub classroom -[$br3] +{br3} .p За всеки практикум ще ви направя линк, чрез който след малко кликане ще се създаде ново лично repository за всеки от вас. .p -До 12:20 трябва да сте качили работата си [=по време=] на упражнението в това repository. +До 12:20 трябва да сте качили работата си {b по време} на упражнението в това repository. GitHub предоставя лесни начини да правите промени по файлове директно чрез браузъра, така че за незаинтересуваните, може да го ползвате като усложнен Google Drive. .p @@ -126,14 +129,14 @@ GitHub предоставя лесни начини да правите пром .p За всяко упражнение ще има отделен линк.\n -Този за днеска е: [url https://classroom.github.com/a/W7hZDMgC classroom.github.com/a/W7hZDMgC] +Този за днеска е: {url classroom.github.com/a/W7hZDMgC;https://classroom.github.com/a/W7hZDMgC} -[$br1] +{br1} :row .p След като го отворите, ще видите съобщение за разрешение, авторизирайте го. -.p [image ./img/github-classroom-authorize.gif] +.p {img ./img/github-classroom-authorize.gif} @@ -141,7 +144,7 @@ GitHub предоставя лесни начини да правите пром :row -.width60% [image ./img/join-the-classroom.gif] +.width60% {img ./img/join-the-classroom.gif} :column @@ -158,12 +161,12 @@ GitHub предоставя лесни начини да правите пром .p След това, би трябвало да видите страницата за "Приемане на заданието". -.width40% [image ./img/accept-assignment.gif] +.width40% {img ./img/accept-assignment.gif} .p След като го приемете, на новата страница, изчакайте няколко секунди и презаредете. Трябва да видите това: -.width40% [image ./img/ready-to-go.gif] +.width40% {img ./img/ready-to-go.gif} :middle_slide @@ -188,24 +191,24 @@ GitHub предоставя лесни начини да правите пром Целта е да видя какво правите и да ви помогна, моля проверявайте какво съм ви писал, по подразбиране би трябвало да получавате известия на имейл-а. .centered -.width80% [image ./img/feedback.gif] +.width80% {img ./img/feedback.gif} :slide ## Къде пишем код? -[$br2] +{br2} .p -[=Кодът е чисто и просто текст=], компилаторът е специалната програма, която превръща този текст в нещо, което може компютъра да изпълни. +{b Кодът е чисто и просто текст}, компилаторът е специалната програма, която превръща този текст в нещо, което може компютъра да изпълни. .p -За писане и редактиране на текст ползваме [=текстови редактори=]. +За писане и редактиране на текст ползваме {b текстови редактори}. Програмистите са искали да улеснят работата си, затова модерните текстови редактори поддържат много помощни функционалности: показване на грешки на точния ред, автоматично форматиране, ... .p -За някои и това не е било достатъчно удобно, затова са създадени [=Integrated Development Environment=] (IDE), програми които съдържат в себе си всичко нужно за разработка на код. +За някои и това не е било достатъчно удобно, затова са създадени {b Integrated Development Environment} (IDE), програми които съдържат в себе си всичко нужно за разработка на код. Тоест, те са текстови редактори, но "вградено" могат да компилират код, да менижират сегашното repository, ... @@ -232,20 +235,20 @@ GitHub предоставя лесни начини да правите пром ### Инсталация -[$br1] +{br1} .p Намираме се в компютърна зала, така че всички предоставени компютри би трябвало вече да са налични на предоставените компютри. За ваши лични машини, ще минем набързо през информацията тук. .p -За Visual Studio Code, отивате на [url https://code.visualstudio.com/Download code.visualstudio.com/Download], избирате своята операционна система (за Уиндоус, ако не сте сигурни, изберете "System Installer x64") и инсталирате. +За Visual Studio Code, отивате на {url code.visualstudio.com/Download;https://code.visualstudio.com/Download}, избирате своята операционна система (за Уиндоус, ако не сте сигурни, изберете "System Installer x64") и инсталирате. .p -За Visual Studio, отивате на [url https://visualstudio.microsoft.com/ visualstudio.microsoft.com], скролвате малко надолу, избирате "Download Visual Studio" и след това "Community 2022". +За Visual Studio, отивате на {url visualstudio.microsoft.com;https://visualstudio.microsoft.com/}, скролвате малко надолу, избирате "Download Visual Studio" и след това "Community 2022". .bulleted 'footnote vs-2022-old-win Може би има трикове с които да инсталирате 2022 версията, но те не са официални и затова няма да го преподам -- Ако искате да ползвате по-стара ОС, като Windows 8.1 или Windows 7 ще трябва да използвате "Community 2019"[$vs-2022-old-win], разликата между версиите не е съществена, затова не се притеснявайте. +- Ако искате да ползвате по-стара ОС, като Windows 8.1 или Windows 7 ще трябва да използвате "Community 2019"{vs-2022-old-win}, разликата между версиите не е съществена, затова не се притеснявайте. :slide @@ -258,7 +261,7 @@ GitHub предоставя лесни начини да правите пром Би трябвало да заема към 11 GB памет и в моето тестване се инсталира за 10тина минути. .centered -.width80% [image ./img/vs-install.gif] +.width80% {img ./img/vs-install.gif} :slide @@ -274,9 +277,9 @@ GitHub предоставя лесни начини да правите пром :width75% :row -.p [image ./img/vs-signin.gif] +.p {img ./img/vs-signin.gif} -.p [image ./img/vs-start-env.gif] +.p {img ./img/vs-start-env.gif} @@ -291,7 +294,7 @@ GitHub предоставя лесни начини да правите пром В лявата колона имате скорошни проекти, в дясната имате начини да създадете нов проект. :centered -:width80% [image ./img/vs-open-recent.gif] +:width80% {img ./img/vs-open-recent.gif} @@ -304,7 +307,7 @@ GitHub предоставя лесни начини да правите пром В този курс ще работим само и единствено с "Console App", затова изберете него и кликнете "Next". :centered -:width75% [image ./img/vs-create-project.gif] +:width75% {img ./img/vs-create-project.gif} @@ -316,7 +319,7 @@ GitHub предоставя лесни начини да правите пром Тук единствено може да искате да промените Project Name и Location, другото не е важно. :centered -:width80% [image ./img/vs-configure-project.gif] +:width80% {img ./img/vs-configure-project.gif} @@ -348,7 +351,7 @@ GitHub предоставя лесни начини да правите пром :centered :width60% -.p [image ./img/vs-general.gif] +.p {img ./img/vs-general.gif} @@ -356,7 +359,7 @@ GitHub предоставя лесни начини да правите пром В Solution Explorer имате всички файлове от проекта (Visual Studio позволява да групирате няколко проекта в едно, наречено Solution, не е нужно да се занимавате). .p -Тук [=единственото важно за вас се намира в папката "Source Files"=]. +Тук {b единственото важно за вас се намира в папката "Source Files"}. В нея ще се намира вашия код, всичко останало са допълнителни неща, които са релевантни за по-големи проекти. @@ -369,7 +372,7 @@ GitHub предоставя лесни начини да правите пром :width50% :fright -.p [image ./img/vs-debug-menu.gif] +.p {img ./img/vs-debug-menu.gif} @@ -377,14 +380,14 @@ GitHub предоставя лесни начини да правите пром .p След малко чакане, би трябвало да излезе един прозорец, който изглежда горе-долу така: -.p [image ./img/vs-console.gif] +.p {img ./img/vs-console.gif} :slide ### Как да дебъгваме с Visual Studio -[$br1] +{br1} .p Bug е когато нещо непланирано се случи в кода. @@ -397,7 +400,7 @@ Visual Studio предоставя много функционалности, к .p При компилиране, ще получим съобщение за грешки по време на компилирането. -.p [image ./img/vs-build-errors.gif] +.p {img ./img/vs-build-errors.gif} :slide @@ -412,7 +415,7 @@ Visual Studio предоставя много функционалности, к Той се появява когато при компилиране получим грешки и изчезва когато няма. :centered -:width70% [image ./img/vs-errors.gif] +:width70% {img ./img/vs-errors.gif} @@ -430,9 +433,9 @@ Visual Studio предоставя много функционалности, к Най-елементарния начин: копирате всичко, след това отивате на вашето GitHub repository, кликвате "Add", после "Create new file". .p -Отгоре на "Name your file..." пишете някакво име, което [=моля да завърша на [`.cpp`]!=] +Отгоре на "Name your file..." пишете някакво име, което {b моля да завърша на {` .cpp}!} Това показва, че файла съдържа код на C++. -Също, когато решавате много задачи и създавате много такива файлове, [=напомням че имената на файловете трябва да са различни.=] +Също, когато решавате много задачи и създавате много такива файлове, {b напомням че имената на файловете трябва да са различни.} .p В "Enter file contents here" пействате копирания код. @@ -441,4 +444,4 @@ Visual Studio предоставя много функционалности, к :middle_slide -## Вече имате достатъчно информация да пишете код сами, [url ./ време е за задачи] +## Вече имате достатъчно информация да пишете код сами, {url време е за задачи;./} |