From 88a5b49611a0a4d1eb47ba86b9123159443ce4cb Mon Sep 17 00:00:00 2001 From: Syndamia Date: Tue, 23 Dec 2025 22:54:20 +0200 Subject: feat!: Update dunbar after inline brace character swap --- src/about.du | 52 +-- src/about/index.du | 52 +-- src/accessibility.du | 2 +- src/blog.du | 70 ++-- src/blog/2.6-years-of-web-design/index.du | 12 +- src/blog/bash-is-weird/index.du | 26 +- src/blog/connect-to-mysql-in-dotnet-ef/index.du | 20 +- src/blog/disable-sticky-keys-popup/index.du | 12 +- src/blog/encrypted-email/index.du | 22 +- src/blog/export-skype/index.du | 32 +- src/blog/fix-network-brother-printers/index.du | 24 +- src/blog/fix-no-frame-buffer-plan9/index.du | 10 +- src/blog/fix-qc-timeout/index.du | 14 +- .../balove-2021.du | 12 +- .../index.du | 68 ++-- .../index.du | 28 +- src/blog/how-to-encrypt-email/index.du | 38 +- src/blog/how-to-use-jira/bug.du | 8 +- src/blog/how-to-use-jira/cards.du | 56 +-- src/blog/how-to-use-jira/components.du | 14 +- src/blog/how-to-use-jira/dashboards.du | 24 +- src/blog/how-to-use-jira/filters.du | 14 +- src/blog/how-to-use-jira/index.du | 2 +- src/blog/how-to-use-jira/kanban.du | 8 +- src/blog/how-to-use-jira/pages.du | 8 +- src/blog/how-to-use-jira/projects.du | 60 +-- src/blog/how-to-use-jira/releases.du | 6 +- src/blog/how-to-use-jira/scrum.du | 20 +- .../index.du | 20 +- src/blog/index.du | 70 ++-- .../install-drivers-for-epson-scanners/index.du | 24 +- src/blog/install-plan9-with-virt-manager/index.du | 28 +- .../managing-apps-with-adb-without-root/index.du | 20 +- src/blog/microsoft-and-foss-extinguish/index.du | 2 +- .../mundus-first-shot-at-gamedev/basic-concepts.du | 8 +- src/blog/mundus-first-shot-at-gamedev/index.du | 4 +- .../mundus-first-shot-at-gamedev/introduction.du | 4 +- src/blog/mundus-first-shot-at-gamedev/timeline.du | 14 +- .../mundus-first-shot-at-gamedev/user-interface.du | 20 +- src/blog/plan9-in-linux-mouse-menus/index.du | 38 +- src/blog/remove-weather-widget/index.du | 4 +- .../sane-explanation-of-compilers/part-1/index.du | 296 +++++++-------- src/blog/switchut-izgorq/index.du | 4 +- src/blog/taming-the-fun-too/index.du | 26 +- .../index.du | 76 ++-- .../thinkpad-x270-my-favorite-machine/index.du | 16 +- src/blog/turn-off-notifications-windows/index.du | 8 +- .../index.du | 10 +- src/blog/windows-run-dialog/index.du | 106 +++--- src/license.du | 4 +- src/misc/universitetski-belejki/index.du | 2 +- src/preserved-media.du | 2 +- src/preserved-media/index.du | 2 +- src/preserved-web-pages.du | 2 +- src/preserved-web-pages/index.du | 2 +- src/privacy.du | 2 +- src/regarding-js.du | 16 +- src/rework.du | 4 +- src/setup.du | 6 +- src/setup/index.du | 6 +- src/slides.du | 8 +- src/slides/demo/index.du | 18 +- src/slides/index.du | 8 +- src/slides/linuxgraphy-by-strabo/index.du | 402 ++++++++++----------- src/teaching.du | 4 +- src/teaching/index.du | 4 +- src/teaching/oop-2023/index.du | 12 +- src/teaching/oop-2023/week1/good-software.du | 60 +-- src/teaching/oop-2023/week1/index.du | 20 +- src/teaching/oop-2023/week1/organization.du | 4 +- src/teaching/oop-2023/week10/index.du | 78 ++-- src/teaching/oop-2023/week11/index.du | 96 ++--- src/teaching/oop-2023/week12/index.du | 48 +-- src/teaching/oop-2023/week13/index.du | 80 ++-- src/teaching/oop-2023/week14/index.du | 2 +- src/teaching/oop-2023/week15/index.du | 2 +- src/teaching/oop-2023/week16/index.du | 2 +- src/teaching/oop-2023/week2/index.du | 74 ++-- src/teaching/oop-2023/week3/index.du | 44 +-- src/teaching/oop-2023/week4/index.du | 46 +-- src/teaching/oop-2023/week5/index.du | 24 +- src/teaching/oop-2023/week6/index.du | 28 +- src/teaching/oop-2023/week7/index.du | 20 +- src/teaching/oop-2023/week8/index.du | 34 +- src/teaching/oop-2023/week9/index.du | 42 +-- src/teaching/upp-2023/additional1/index.du | 72 ++-- src/teaching/upp-2023/additional2/index.du | 112 +++--- src/teaching/upp-2023/index.du | 8 +- src/teaching/upp-2023/week1/index.du | 6 +- src/teaching/upp-2023/week1/setup.du | 26 +- src/teaching/upp-2023/week1/welcome.du | 24 +- src/teaching/upp-2023/week10/index.du | 36 +- src/teaching/upp-2023/week11/index.du | 38 +- src/teaching/upp-2023/week12/index.du | 40 +- src/teaching/upp-2023/week13/index.du | 18 +- src/teaching/upp-2023/week14/index.du | 2 +- src/teaching/upp-2023/week2/index.du | 72 ++-- src/teaching/upp-2023/week2/revision.du | 54 +-- src/teaching/upp-2023/week3/index.du | 106 +++--- src/teaching/upp-2023/week3/revision.du | 36 +- src/teaching/upp-2023/week4/index.du | 64 ++-- src/teaching/upp-2023/week4/revision.du | 22 +- src/teaching/upp-2023/week5/index.du | 52 +-- src/teaching/upp-2023/week5/revision.du | 16 +- src/teaching/upp-2023/week6/index.du | 58 +-- src/teaching/upp-2023/week7/index.du | 74 ++-- src/teaching/upp-2023/week8/index.du | 38 +- src/teaching/upp-2023/week9/index.du | 32 +- src/teaching/upp-2025/cpp-pitfalls/index.du | 112 +++--- src/teaching/upp-2025/ideas.du | 324 +++++++++++++++++ src/teaching/upp-2025/index.du | 12 +- src/teaching/upp-2025/week01/concepts.du | 24 +- src/teaching/upp-2025/week01/github_classroom.du | 6 +- src/teaching/upp-2025/week01/index.du | 4 +- src/teaching/upp-2025/week01/introduction.du | 36 +- src/teaching/upp-2025/week01/visual_studio.du | 8 +- src/teaching/upp-2025/week01/zip.du | 12 +- src/teaching/upp-2025/week02/index.du | 28 +- src/teaching/upp-2025/week02/machine.du | 30 +- src/teaching/upp-2025/week02/machine_manual.du | 44 +-- src/teaching/upp-2025/week03/index.du | 24 +- src/teaching/upp-2025/week04/index.du | 38 +- src/teaching/upp-2025/week05/index.du | 30 +- src/teaching/upp-2025/week06/index.du | 18 +- src/teaching/upp-2025/week07/index.du | 62 ++-- src/teaching/upp-2025/week08/index.du | 92 ++--- src/teaching/upp-2025/week09/index.du | 14 +- src/teaching/upp-2025/week10/index.du | 32 +- src/teaching/upp-2025/week11/index.du | 30 +- src/teaching/upp-2025/week12/index.du | 82 ++--- 130 files changed, 2556 insertions(+), 2232 deletions(-) create mode 100644 src/teaching/upp-2025/ideas.du (limited to 'src') diff --git a/src/about.du b/src/about.du index ed53ba7..7a8f289 100644 --- a/src/about.du +++ b/src/about.du @@ -1,7 +1,7 @@ # About Me :defs -; =[Contact me casually]= +; [=Contact me casually=] : syndamia@protonmail.com @@ -19,9 +19,9 @@ PGP key - *[(for this one, make sure to check your spam folder!)]* + [*(for this one, make sure to check your spam folder!)*] -; =[Contact me about work and projects I'm maintaining]= +; [=Contact me about work and projects I'm maintaining=] : kamen.d.mladenov@protonmail.com @@ -40,13 +40,13 @@ PGP key -*[for this one, make sure to check your spam folder!]* +[*for this one, make sure to check your spam folder!*] \n [url https://www.linkedin.com/in/kamen-mladenov/ linkedin.com/in/kamen-mladenov] -; =[Resume]= +; [=Resume=] : [url /files/resume-bg.pdf Български] | [url /files/resume-en.pdf English] @@ -57,7 +57,7 @@ I'm a [url https://www.fmi.uni-sofia.bg/en university] student and general computer nerd. -My current interests include: operating systems, functional programming, webdev (without =[any]= libraries, pure JavaScript), old tech, some amount of server administration and a teeny weeny bit of computer history. +My current interests include: operating systems, functional programming, webdev (without [=any=] libraries, pure JavaScript), old tech, some amount of server administration and a teeny weeny bit of computer history. I have a good amount of [url https://gitlab.com/users/Syndamia/projects projects under my belt], although very few are actually useful. I've put down the more notable ones [url /software here], but [url https://github.com/Syndamia/filite-list filite-list] and [url https://github.com/Syndamia/min-youtube-element-blocker min-youtube-element-blocker] seem to have gotten the most attention (if any). @@ -75,49 +75,49 @@ This is a curated list of the more relevant software projects I've made or heavi \n -#### *[2023]* +#### [*2023*] :defs ; [url https://gitlab.com/Syndamia/texty-office gitlab / texty-office] + [url https://gitlab.com/Syndamia/texty-office.vim gitlab / texty-office.vim] : An imperfect converter from DOCX, PPTX and XLSX to normal text with it's associated [url https://www.vim.org/ Vim] plugin. \n - `[GNU GPLv3]` & `[MIT]` | `[C++]` `[vimscript]` | `[Office file]` `[converter]` `[plugin]` `[Vim]` `[CLI tool]` + [`GNU GPLv3`] & [`MIT`] | [`C++`] [`vimscript`] | [`Office file`] [`converter`] [`plugin`] [`Vim`] [`CLI tool`] -; [url https://gitlab.com/Syndamia/small-web-utilities gitlab / small-web-utilities]   *[maintained]* +; [url https://gitlab.com/Syndamia/small-web-utilities gitlab / small-web-utilities]   [*maintained*] : A collection of small but fast utilities, like a checklist, that work locally on your browser. Also hosted [url https://utils.syndamia.com here]. \n - `[GNU GPLv3]` | `[HTML]` `[Javascript]` | `[checklist]` `[utilities]` + [`GNU GPLv3`] | [`HTML`] [`Javascript`] | [`checklist`] [`utilities`] -; [url https://gitlab.com/Syndamia/ss-law gitlab / ss-law] + [url https://github.com/Syndamia/ss-law github / ss-law]   *[maintained]* +; [url https://gitlab.com/Syndamia/ss-law gitlab / ss-law] + [url https://github.com/Syndamia/ss-law github / ss-law]   [*maintained*] : A small, lightweight and simple static site generation system, extracted as a template from my own \n - `[Markdown]` `[bash]` `[awk]` | `[ssg]` `[lowdown]` `[static site generator]` `[pipelines]` + [`Markdown`] [`bash`] [`awk`] | [`ssg`] [`lowdown`] [`static site generator`] [`pipelines`] -; [url https://gitlab.com/Syndamia/homelander gitlab / homelander]   *[maintained]* +; [url https://gitlab.com/Syndamia/homelander gitlab / homelander]   [*maintained*] : A very small and good looking, handmade prompt for zsh \n - `[GPLv3]` | `[bash]` | `[zsh]` `[shell]` `[prompt]` `[script]` `[Linux]` + [`GPLv3`] | [`bash`] | [`zsh`] [`shell`] [`prompt`] [`script`] [`Linux`] -; [url https://gitlab.com/Syndamia/goodwolf gitlab / goodwolf]   *[abandoned]* +; [url https://gitlab.com/Syndamia/goodwolf gitlab / goodwolf]   [*abandoned*] : Fork of the [url https://hacktivis.me/projects/badwolf badwolf] browser, which aims to add features \n - `[BSD-3-Clause]` | `[C]` | `[web browser]` `[GTK]` `[WebKitGTK]` `[Linux]` + [`BSD-3-Clause`] | [`C`] | [`web browser`] [`GTK`] [`WebKitGTK`] [`Linux`] -#### *[2021]* +#### [*2021*] :defs -; [url https://gitlab.com/Syndamia/reposync gitlab / RepoSync]   *[completed]* +; [url https://gitlab.com/Syndamia/reposync gitlab / RepoSync]   [*completed*] : Script and some config files for synchronizing a git repository with a server \n - `[MIT]` | `[python]` | `[server]` `[git]` `[systemd]` + [`MIT`] | [`python`] | [`server`] [`git`] [`systemd`] -; [url https://github.com/Syndamia/filite-list github / filite-list]   *[completed]* +; [url https://github.com/Syndamia/filite-list github / filite-list]   [*completed*] : Script for managing [url https://github.com/raftario/filite filite] links \n - `[GPLv3]` | `[bash]` | `[filite]` `[server]` `[script]` `[Linux]` + [`GPLv3`] | [`bash`] | [`filite`] [`server`] [`script`] [`Linux`] -#### *[2020]* +#### [*2020*] :defs -; [url https://github.com/Team-Kaleidoscope/DevHive github / DevHive] and [url https://github.com/Team-Kaleidoscope/DevHive-Angular github / DevHive-Angular]   *[completed]* +; [url https://github.com/Team-Kaleidoscope/DevHive github / DevHive] and [url https://github.com/Team-Kaleidoscope/DevHive-Angular github / DevHive-Angular]   [*completed*] : DevHive is a social network oriented towards programmers. It's FOSS, built from the ground up, and made from a team of three for a course. \n - `[GPLv3]` | `[C#]` `[TypeScript]` | `[Angular]` `[ASP.NET Core]` `[social media]` `[mvc]` `[Docker]` `[CSS]` + [`GPLv3`] | [`C#`] [`TypeScript`] | [`Angular`] [`ASP.NET Core`] [`social media`] [`mvc`] [`Docker`] [`CSS`] -; [url https://github.com/Syndamia/min-youtube-element-blocker github / min-youtube-element-blocker]   *[maintained]* +; [url https://github.com/Syndamia/min-youtube-element-blocker github / min-youtube-element-blocker]   [*maintained*] : Userscript for hiding certain UI elements in YouTube \n - `[MIT]` | `[JavaScript]` | `[youtube]` `[userscript]` `[css]` + [`MIT`] | [`JavaScript`] | [`youtube`] [`userscript`] [`css`] diff --git a/src/about/index.du b/src/about/index.du index ed53ba7..7a8f289 100644 --- a/src/about/index.du +++ b/src/about/index.du @@ -1,7 +1,7 @@ # About Me :defs -; =[Contact me casually]= +; [=Contact me casually=] : syndamia@protonmail.com @@ -19,9 +19,9 @@ PGP key - *[(for this one, make sure to check your spam folder!)]* + [*(for this one, make sure to check your spam folder!)*] -; =[Contact me about work and projects I'm maintaining]= +; [=Contact me about work and projects I'm maintaining=] : kamen.d.mladenov@protonmail.com @@ -40,13 +40,13 @@ PGP key -*[for this one, make sure to check your spam folder!]* +[*for this one, make sure to check your spam folder!*] \n [url https://www.linkedin.com/in/kamen-mladenov/ linkedin.com/in/kamen-mladenov] -; =[Resume]= +; [=Resume=] : [url /files/resume-bg.pdf Български] | [url /files/resume-en.pdf English] @@ -57,7 +57,7 @@ I'm a [url https://www.fmi.uni-sofia.bg/en university] student and general computer nerd. -My current interests include: operating systems, functional programming, webdev (without =[any]= libraries, pure JavaScript), old tech, some amount of server administration and a teeny weeny bit of computer history. +My current interests include: operating systems, functional programming, webdev (without [=any=] libraries, pure JavaScript), old tech, some amount of server administration and a teeny weeny bit of computer history. I have a good amount of [url https://gitlab.com/users/Syndamia/projects projects under my belt], although very few are actually useful. I've put down the more notable ones [url /software here], but [url https://github.com/Syndamia/filite-list filite-list] and [url https://github.com/Syndamia/min-youtube-element-blocker min-youtube-element-blocker] seem to have gotten the most attention (if any). @@ -75,49 +75,49 @@ This is a curated list of the more relevant software projects I've made or heavi \n -#### *[2023]* +#### [*2023*] :defs ; [url https://gitlab.com/Syndamia/texty-office gitlab / texty-office] + [url https://gitlab.com/Syndamia/texty-office.vim gitlab / texty-office.vim] : An imperfect converter from DOCX, PPTX and XLSX to normal text with it's associated [url https://www.vim.org/ Vim] plugin. \n - `[GNU GPLv3]` & `[MIT]` | `[C++]` `[vimscript]` | `[Office file]` `[converter]` `[plugin]` `[Vim]` `[CLI tool]` + [`GNU GPLv3`] & [`MIT`] | [`C++`] [`vimscript`] | [`Office file`] [`converter`] [`plugin`] [`Vim`] [`CLI tool`] -; [url https://gitlab.com/Syndamia/small-web-utilities gitlab / small-web-utilities]   *[maintained]* +; [url https://gitlab.com/Syndamia/small-web-utilities gitlab / small-web-utilities]   [*maintained*] : A collection of small but fast utilities, like a checklist, that work locally on your browser. Also hosted [url https://utils.syndamia.com here]. \n - `[GNU GPLv3]` | `[HTML]` `[Javascript]` | `[checklist]` `[utilities]` + [`GNU GPLv3`] | [`HTML`] [`Javascript`] | [`checklist`] [`utilities`] -; [url https://gitlab.com/Syndamia/ss-law gitlab / ss-law] + [url https://github.com/Syndamia/ss-law github / ss-law]   *[maintained]* +; [url https://gitlab.com/Syndamia/ss-law gitlab / ss-law] + [url https://github.com/Syndamia/ss-law github / ss-law]   [*maintained*] : A small, lightweight and simple static site generation system, extracted as a template from my own \n - `[Markdown]` `[bash]` `[awk]` | `[ssg]` `[lowdown]` `[static site generator]` `[pipelines]` + [`Markdown`] [`bash`] [`awk`] | [`ssg`] [`lowdown`] [`static site generator`] [`pipelines`] -; [url https://gitlab.com/Syndamia/homelander gitlab / homelander]   *[maintained]* +; [url https://gitlab.com/Syndamia/homelander gitlab / homelander]   [*maintained*] : A very small and good looking, handmade prompt for zsh \n - `[GPLv3]` | `[bash]` | `[zsh]` `[shell]` `[prompt]` `[script]` `[Linux]` + [`GPLv3`] | [`bash`] | [`zsh`] [`shell`] [`prompt`] [`script`] [`Linux`] -; [url https://gitlab.com/Syndamia/goodwolf gitlab / goodwolf]   *[abandoned]* +; [url https://gitlab.com/Syndamia/goodwolf gitlab / goodwolf]   [*abandoned*] : Fork of the [url https://hacktivis.me/projects/badwolf badwolf] browser, which aims to add features \n - `[BSD-3-Clause]` | `[C]` | `[web browser]` `[GTK]` `[WebKitGTK]` `[Linux]` + [`BSD-3-Clause`] | [`C`] | [`web browser`] [`GTK`] [`WebKitGTK`] [`Linux`] -#### *[2021]* +#### [*2021*] :defs -; [url https://gitlab.com/Syndamia/reposync gitlab / RepoSync]   *[completed]* +; [url https://gitlab.com/Syndamia/reposync gitlab / RepoSync]   [*completed*] : Script and some config files for synchronizing a git repository with a server \n - `[MIT]` | `[python]` | `[server]` `[git]` `[systemd]` + [`MIT`] | [`python`] | [`server`] [`git`] [`systemd`] -; [url https://github.com/Syndamia/filite-list github / filite-list]   *[completed]* +; [url https://github.com/Syndamia/filite-list github / filite-list]   [*completed*] : Script for managing [url https://github.com/raftario/filite filite] links \n - `[GPLv3]` | `[bash]` | `[filite]` `[server]` `[script]` `[Linux]` + [`GPLv3`] | [`bash`] | [`filite`] [`server`] [`script`] [`Linux`] -#### *[2020]* +#### [*2020*] :defs -; [url https://github.com/Team-Kaleidoscope/DevHive github / DevHive] and [url https://github.com/Team-Kaleidoscope/DevHive-Angular github / DevHive-Angular]   *[completed]* +; [url https://github.com/Team-Kaleidoscope/DevHive github / DevHive] and [url https://github.com/Team-Kaleidoscope/DevHive-Angular github / DevHive-Angular]   [*completed*] : DevHive is a social network oriented towards programmers. It's FOSS, built from the ground up, and made from a team of three for a course. \n - `[GPLv3]` | `[C#]` `[TypeScript]` | `[Angular]` `[ASP.NET Core]` `[social media]` `[mvc]` `[Docker]` `[CSS]` + [`GPLv3`] | [`C#`] [`TypeScript`] | [`Angular`] [`ASP.NET Core`] [`social media`] [`mvc`] [`Docker`] [`CSS`] -; [url https://github.com/Syndamia/min-youtube-element-blocker github / min-youtube-element-blocker]   *[maintained]* +; [url https://github.com/Syndamia/min-youtube-element-blocker github / min-youtube-element-blocker]   [*maintained*] : Userscript for hiding certain UI elements in YouTube \n - `[MIT]` | `[JavaScript]` | `[youtube]` `[userscript]` `[css]` + [`MIT`] | [`JavaScript`] | [`youtube`] [`userscript`] [`css`] diff --git a/src/accessibility.du b/src/accessibility.du index d9356cd..7ed44d3 100644 --- a/src/accessibility.du +++ b/src/accessibility.du @@ -25,7 +25,7 @@ Even my [url /talks talks], where each one is a collection of delicately crafted First, icons on this website are managed with an icon font. I've watched [url https://www.youtube.com/watch?v=9xXBYcWgCHA Seren Davies' talk], but I've found working with SVGs noticeably increases workload on my end. -=[However]=, I've still implemented those icons with accessibility in mind: +[=However=], I've still implemented those icons with accessibility in mind: :unordered - Navigation is done with text entries in the sidebar, not icons. diff --git a/src/blog.du b/src/blog.du index 76b3929..cf0bf46 100644 --- a/src/blog.du +++ b/src/blog.du @@ -4,110 +4,110 @@ Articles detailing personal experiences or exploration of certain topics. \n -#### *[2024]* +#### [*2024*] :defs ; [$bg] 18 Nov   [url /blog/switchut-izgorq Суичът изгоря!] -: `[Shallow dive]` | `[Story]` | `[Networking]` `[Switch]` `[NetworkPartner]` +: [`Shallow dive`] | [`Story`] | [`Networking`] [`Switch`] [`NetworkPartner`] ; [$gb] 06 Oct   [url /blog/the-physics-behind-a-black-hole-shader The physics behind a black hole shader] -: `[Deep dive]` | `[Physics]` | `[General theory of relativity]` `[Celestial mechanics]` `[Gravity]` `[Black Hole]` `[Algorithm]` +: [`Deep dive`] | [`Physics`] | [`General theory of relativity`] [`Celestial mechanics`] [`Gravity`] [`Black Hole`] [`Algorithm`] ; [$gb] 20 Feb   [url /blog/microsoft-and-foss-extinguish Microsoft and FOSS: a fire to be extinguished] -: `[Shallow dive]` | `[Opinion]` | `[Microsoft]` `[GitHub]` `[Linux]` `[FOSS]` +: [`Shallow dive`] | [`Opinion`] | [`Microsoft`] [`GitHub`] [`Linux`] [`FOSS`] -#### *[2023]* +#### [*2023*] :defs ; [$gb] 16 Dec   [url /blog/fix-qc-timeout Fix "qc timeout" kernel log error] -: `[Linux]` | `[kernel]` | `[libata]` `[qc]` `[logs]` `[DMA]` +: [`Linux`] | [`kernel`] | [`libata`] [`qc`] [`logs`] [`DMA`] ; [$gb] 30 Aug   [url /blog/thinkpad-x270-my-favorite-machine ThinkPad X270 - my favorite machine] -: `[Medium dive]` | `[Review]` | `[Lenovo]` `[ThinkPad]` `[Yoga]` +: [`Medium dive`] | [`Review`] | [`Lenovo`] [`ThinkPad`] [`Yoga`] ; [$gb] 19 Jul   [url /blog/icon-fonts-arent-evil-you-just-have-to-care Icon fonts aren't evil, you just have to care] -: `[Shallow dive]` | `[Web development]` | `[Icon font]` `[SVG]` `[Accessibility]` `[FontForge]` +: [`Shallow dive`] | [`Web development`] | [`Icon font`] [`SVG`] [`Accessibility`] [`FontForge`] ; [$bg] 14 Jul   [url /blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq ФМИ и висшето образование в програмистката индустрия] -: `[Deep dive]` | `[University]` | `[FMI]` `[Education]` +: [`Deep dive`] | [`University`] | [`FMI`] [`Education`] ; [$gb] 28 Jun   [url /blog/fix-network-brother-printers Fix networked Brother printers not working in Linux] -: `[Linux]` | `[CUPS]` | `[Printers]` `[Brother]` `[Network]` `[avahi]` +: [`Linux`] | [`CUPS`] | [`Printers`] [`Brother`] [`Network`] [`avahi`] ; [$gb] 14 Jun   [url /blog/gns3-initsh-no-such-file Fix "exec /gns3/init.sh: no such file or directory"] -: `[Linux]` | `[GNS3]` | `[Docker]` `[busybox]` +: [`Linux`] | [`GNS3`] | [`Docker`] [`busybox`] ; [$gb] 07 Jun   [url /blog/friendship-ended-with-funtoo-now-gentoo-is-my-best-friend Friendship ended with Funtoo, now Gentoo is my best friend] -: `[Shallow dive]` | `[Linux]` | `[Funtoo]` `[Gentoo]` `[portage]` `[packages]` `[emerge]` `[ebuild]` +: [`Shallow dive`] | [`Linux`] | [`Funtoo`] [`Gentoo`] [`portage`] [`packages`] [`emerge`] [`ebuild`] ; [$gb] 01 May   [url /blog/bash-is-weird BASH is weird] -: `[Shallow dive]` | `[bash]` | `[Linux]` `[scripting]` +: [`Shallow dive`] | [`bash`] | [`Linux`] [`scripting`] ; [$gb] 26 Apr   [url /blog/install-drivers-for-epson-scanners Install drivers for Epson scanners] -: `[Linux]` | `[SANE]` | `[Scanners]` `[Epson]` `[epkowa]` `[iscan]` +: [`Linux`] | [`SANE`] | [`Scanners`] [`Epson`] [`epkowa`] [`iscan`] ; [$gb] 25 Apr   [url /blog/managing-apps-with-adb-without-root Managing Android apps with ADB (and without root)] -: `[Android]` | `[ADB]` | `[Apps]` `[Linux]` `[Windows]` +: [`Android`] | [`ADB`] | [`Apps`] [`Linux`] [`Windows`] ; [$gb] 18 Apr   [url /blog/sane-explanation-of-compilers/part-1 Sane explanation of compilers: Part 1] -: `[Deep dive]` | `[Compilers]` | `[C]` `[yacc]` `[bison]` `[math]` `[Trees]` `[Regex]` `[Grammar]` `[Languages]` +: [`Deep dive`] | [`Compilers`] | [`C`] [`yacc`] [`bison`] [`math`] [`Trees`] [`Regex`] [`Grammar`] [`Languages`] ; [$gb] 13 Jan   [url /blog/plan9-in-linux-mouse-menus Plan 9 in Linux: Mouse menus] -: `[Medium dive]` | `[Linux]` | `[Plan 9]` `[mouse]` `[bash]` `[script]` `[X11]` `[openbox]` `[jgmenu]` `[plumber]` +: [`Medium dive`] | [`Linux`] | [`Plan 9`] [`mouse`] [`bash`] [`script`] [`X11`] [`openbox`] [`jgmenu`] [`plumber`] ; [$gb] 01 Jan   [url /blog/virt-manager-freeze-on-browse virt-manager freezing up when clicking Browse in any window] -: `[Linux]` | `[virt-manager]` | `[QEMU/KVM]` `[libvirt]` `[Linux]` `[GTK]` +: [`Linux`] | [`virt-manager`] | [`QEMU/KVM`] [`libvirt`] [`Linux`] [`GTK`] -#### *[2022]* +#### [*2022*] :defs ; [$gb] 23 Dec   [url /blog/2.6-years-of-web-design 2.6 years of web design] -: `[Shallow dive]` | `[Web design]` +: [`Shallow dive`] | [`Web design`] ; [$gb] 13 Dec   [url /blog/when-a-language-forces-simpler-thinking When a language forces simpler thinking] -: `[Shallow dive]` | `[Common Lisp]` | `[Advent of Code]` +: [`Shallow dive`] | [`Common Lisp`] | [`Advent of Code`] ; [$gb] 04 Dec   [url /blog/taming-the-fun-too Taming The Fun-too] -: `[Story]` | `[Funtoo]` | `[Linux]` `[Gentoo]` `[packages]` +: [`Story`] | [`Funtoo`] | [`Linux`] [`Gentoo`] [`packages`] ; [$gb] 01 Nov   [url /blog/turn-off-notifications-windows How to turn off notifications on Windows] -: `[Windows 10]` | `[Settings]` | `[Notifications]` +: [`Windows 10`] | [`Settings`] | [`Notifications`] ; [$gb] 01 Nov   [url /blog/disable-sticky-keys-popup How to disable Sticky Keys prompt] -: `[Windows]` | `[Settings]` | `[Sticky Keys]` +: [`Windows`] | [`Settings`] | [`Sticky Keys`] ; [$gb] 26 Oct   [url /blog/remove-weather-widget How to remove Windows Weather Widget] -: `[Windows 10]` | `[Settings]` | `[Taskbar]` `[Weather Widget]` +: [`Windows 10`] | [`Settings`] | [`Taskbar`] [`Weather Widget`] ; [$gb] 04 Oct   [url /blog/windows-run-dialog Windows Run dialog] -: `[Windows]` | `[Commands]` | `[Run]` `[Settings]` +: [`Windows`] | [`Commands`] | [`Run`] [`Settings`] ; [$gb] 03 Oct   [url /blog/export-skype How to export Skype data] -: `[Skype]` | `[Export]` | `[Archive]` `[skype-parser]` +: [`Skype`] | [`Export`] | [`Archive`] [`skype-parser`] ; [$gb] 16 Sep   [url /blog/how-to-encrypt-email How to encrypt email] -: `[All]` | `[Email]` | `[PGP]` `[S/MIME]` `[Email Client]` `[Gmail]` `[Outlook]` `[Protonmail]` +: [`All`] | [`Email`] | [`PGP`] [`S/MIME`] [`Email Client`] [`Gmail`] [`Outlook`] [`Protonmail`] ; [$gb] 10 Sep   [url /blog/encrypted-email Encrypted email] -: `[Medium dive]` | `[Email]` | `[Encryption]` `[Security]` `[PGP]` `[S/MIME]` `[Protonmail]` `[Tutanota]` +: [`Medium dive`] | [`Email`] | [`Encryption`] [`Security`] [`PGP`] [`S/MIME`] [`Protonmail`] [`Tutanota`] ; [$gb] 30 Jul   [url /blog/fix-no-frame-buffer-plan9 Fix "No frame buffer" error in Plan 9] -: `[Plan 9]` | `[Configuration]` | `[QEMU/KVM]` `[Linux]` `[monitor]` +: [`Plan 9`] | [`Configuration`] | [`QEMU/KVM`] [`Linux`] [`monitor`] ; [$gb] 30 Jul   [url /blog/install-plan9-with-virt-manager Install Plan 9 with virt-manager] -: `[Plan 9]` | `[Installation]` | `[Setup]` `[QEMU/KVM]` `[virt-manager]` `[Linux]` +: [`Plan 9`] | [`Installation`] | [`Setup`] [`QEMU/KVM`] [`virt-manager`] [`Linux`] -#### *[2020]* +#### [*2020*] :defs ; [$gb] 24 Jul   [url /blog/how-to-use-jira How to use Jira] -: `[Project Management]` | `[Jira]` | `[Agile]` `[Issue tracking]` `[Bug tracking]` `[Kanban]` `[Atlassian]` +: [`Project Management`] | [`Jira`] | [`Agile`] [`Issue tracking`] [`Bug tracking`] [`Kanban`] [`Atlassian`] ; [$gb] 21 May   [url /blog/connect-to-mysql-in-dotnet-ef Connect to Mysql in .NET and Entity Framework] -: `[ASP.Net]` | `[MySQL]` | `[Entity Framework]` `[Pomelo]` +: [`ASP.Net`] | [`MySQL`] | [`Entity Framework`] [`Pomelo`] ; [$gb] 20 May   [url /blog/mundus-first-shot-at-gamedev Mundus: My first shot at game development] -: `[Deep dive]` | `[Gamedev]` | `[2D]` `[Sandbox]` `[Crafting]` `[Building]` `[Fighting]` `[GtkSharp 2.0]` `[C#]` +: [`Deep dive`] | [`Gamedev`] | [`2D`] [`Sandbox`] [`Crafting`] [`Building`] [`Fighting`] [`GtkSharp 2.0`] [`C#`] diff --git a/src/blog/2.6-years-of-web-design/index.du b/src/blog/2.6-years-of-web-design/index.du index 10d1237..2678065 100644 --- a/src/blog/2.6-years-of-web-design/index.du +++ b/src/blog/2.6-years-of-web-design/index.du @@ -31,7 +31,7 @@ For code blocks, the background was a dark-blue color with a blue-ish font color [image ./img/v1.0-code\ block.png] -Although I wasn't the one to invent that color scheme, it was *[inspired]* from [url https://github.com/linuxmint/xed xed]'s Oblivion theme. +Although I wasn't the one to invent that color scheme, it was [*inspired*] from [url https://github.com/linuxmint/xed xed]'s Oblivion theme. It wasn't all completely bonkers, there were some not-so-ugly design decisions. Navigation was done with tabs, which look decently nice on a desktop. @@ -51,9 +51,9 @@ Finally, tables, like those used in the "Projects" listing, were the absolute du [image ./img/v1.0-projects.png] As you can see, the design was overwhelmingly ugly, with many boneheaded decisions behind it. -Did I mention every post had to be written entirely by hand in HTML, except for the headers and footers, which were [url https://gitlab.com/Syndamia/syndamiadotcom/-/tree/v1.0/website/js =[generated client-side with JavaScript]=]? +Did I mention every post had to be written entirely by hand in HTML, except for the headers and footers, which were [url https://gitlab.com/Syndamia/syndamiadotcom/-/tree/v1.0/website/js [=generated client-side with JavaScript=]]? -Nonetheless, it served as a good starting point and stepping stone, for my web development *[adventures]*. +Nonetheless, it served as a good starting point and stepping stone, for my web development [*adventures*]. ### v2.0 @@ -171,7 +171,7 @@ That's where everything stayed for a while. ### v3.0 -Of course, there were changes, I wrote more posts, tweaked some of the styling, hell, I even started adding (=[non required]=) JavaScript functionality. +Of course, there were changes, I wrote more posts, tweaked some of the styling, hell, I even started adding ([=non required=]) JavaScript functionality. Still, I was yearning for something better. Scalability was continuing to be an issue, outside of the annoying misalignment, navigation buttons in the header or footer would disappear into the void if it's contents were too long: @@ -239,7 +239,7 @@ Happy holidays everyone! This post has been in the works since 01 August 2020. At the time it was just called [url https://gitlab.com/Syndamia/syndamiadotcom/-/tree/501942b638c34582de2f73dc31423c9322eb81fd/src/blog/syndamiadotcom "syndamiadotcom"] and was listed under the now defunct "Projects" section. -It was actually still available on the website, under `[/blog/syndamiadotcom/]`, but I didn't list it in the blogs page. +It was actually still available on the website, under [`/blog/syndamiadotcom/`], but I didn't list it in the blogs page. That first iteration looked at the layout in a much stiffer and uninteresting way. I was talking about what exact color codes I used for crying out loud. @@ -252,4 +252,4 @@ As you saw, learning the little I know about web design was a slow trial and err The same will happen with making blog posts and other articles. I'm not a writer and I'm not interested enough to learn things properly. -*[P.S.]* Expect this post to be updated in the future, when I make new releases! +[*P.S.*] Expect this post to be updated in the future, when I make new releases! diff --git a/src/blog/bash-is-weird/index.du b/src/blog/bash-is-weird/index.du index 8bb9632..3fbc2cd 100644 --- a/src/blog/bash-is-weird/index.du +++ b/src/blog/bash-is-weird/index.du @@ -6,7 +6,7 @@ [$pagenav] 'footnote parameter-expansion Of course this is just one of the many ways to reference and work with variables. -For very basic stuff, BASH is decently simple and intuitive, for example variables are set with the format `[name=value]` and they're referenced with `[\$name]` [$parameter-expansion]. +For very basic stuff, BASH is decently simple and intuitive, for example variables are set with the format [`name=value`] and they're referenced with [`\$name`] [$parameter-expansion]. However, that changes once you start diving deeper (as I had to do for my [url /talks/linuxgraphy-by-strabo Linuxgraphy by Strabo] presentation). An example which illustrates my point would be: @@ -18,13 +18,13 @@ echo $((myvar += 46)) ${myvar[\${myvar:0:1}]} It has 3 things which really bothered me: :ordered -1. The output of `[\$(echo A B C)]` is replaced "literally", and then the whole expression is evaluated. - Meaning, `[myvar=($(echo A B C))]` turns into `[myvar=(A B C)]`, which creates an array with those three letters. +1. The output of [`\$(echo A B C)`] is replaced "literally", and then the whole expression is evaluated. + Meaning, [`myvar=($(echo A B C))`] turns into [`myvar=(A B C)`], which creates an array with those three letters. .p - I thought the "returned" value of `[\$(echo A B C)]` would be the whole string "A B C", so the array would have one element, that string. - However, `[\$()]` isn't really a function, which takes arguments, "creates" commands and returns their output. - It's [url https://www.gnu.org/software/bash/manual/html_node/Command-Substitution.html Command =[Substitution]=], the text gets executed and it's output =[replaces]= the `[\$(...)]` itself (slightly reminiscent of [url https://lispcookbook.github.io/cl-cookbook/macros.html LISP macros]). + I thought the "returned" value of [`\$(echo A B C)`] would be the whole string "A B C", so the array would have one element, that string. + However, [`\$()`] isn't really a function, which takes arguments, "creates" commands and returns their output. + It's [url https://www.gnu.org/software/bash/manual/html_node/Command-Substitution.html Command [=Substitution=]], the text gets executed and it's output [=replaces=] the [`\$(...)`] itself (slightly reminiscent of [url https://lispcookbook.github.io/cl-cookbook/macros.html LISP macros]). .p Side note: obviously, the original expected behaviour can happen if we use some quotes: @@ -32,21 +32,21 @@ It has 3 things which really bothered me: ```bash myvar=("$(echo A B C)") -2. On the second line, `[myvar]` *[becomes]* an integer and then we do an arithmetic operation on it, nothing wrong here. - `[\${parameter:offset:length}]` returns the substring from `[parameter]` from `[offset]` with size `[length]`, but we're giving it a "number", so it should either throw some sort of error or return something default, like 0. +2. On the second line, [`myvar`] [*becomes*] an integer and then we do an arithmetic operation on it, nothing wrong here. + [`\${parameter:offset:length}`] returns the substring from [`parameter`] from [`offset`] with size [`length`], but we're giving it a "number", so it should either throw some sort of error or return something default, like 0. However it correctly returns the number 1 (and no, that isn't a default, the number is correctly parsed as a string). .p This shows that numbers are actually strings too, and numerical operations are just weird string operations. Contrary to any dynamically-typed language, it's not like the type of a variable is inferred from it's value, [url https://tldp.org/LDP/abs/html/untyped.html there isn't a type at all]! - Which makes everything even more weird, considering you *[can]* [url https://www.gnu.org/software/bash/manual/bash.html#index-declare create variables with a specific type]. + Which makes everything even more weird, considering you [*can*] [url https://www.gnu.org/software/bash/manual/bash.html#index-declare create variables with a specific type]. -3. Finally, the arguably biggest weirdness of it all, is `[\${myvar[1]}]`. - It doesn't matter how it is represented, at first `[myvar]` was the list of values A, B, C and now it's a number, this should return nothing. - Per contra, the value `[B]` is returned instead! +3. Finally, the arguably biggest weirdness of it all, is [`\${myvar[1]}`]. + It doesn't matter how it is represented, at first [`myvar`] was the list of values A, B, C and now it's a number, this should return nothing. + Per contra, the value [`B`] is returned instead! .p - Via trial and error, we find that our number will be returned when the index is 0, and with index 2 we get `[C]`. + Via trial and error, we find that our number will be returned when the index is 0, and with index 2 we get [`C`]. So all variables are arrays, and by default for integer and string operations, the first value is used? .p diff --git a/src/blog/connect-to-mysql-in-dotnet-ef/index.du b/src/blog/connect-to-mysql-in-dotnet-ef/index.du index 5f0e968..e745f16 100644 --- a/src/blog/connect-to-mysql-in-dotnet-ef/index.du +++ b/src/blog/connect-to-mysql-in-dotnet-ef/index.du @@ -15,13 +15,13 @@ 2. [url #dbcontext-child-class DBContext child class] -I have found that connecting a `[.NET]` application to a `[MySql]` database (with Entity Framework) can be tricky. Here is what works for me. +I have found that connecting a [`.NET`] application to a [`MySql`] database (with Entity Framework) can be tricky. Here is what works for me. -Also, [url https://www.nuget.org/packages/MySql.Data.EntityFrameworkCore/ MySql.Data.EntityFrameworkCore] has been =[depricated]= since *[October 2020]*. If you need setup instructions with it, read [url https://gitlab.com/Syndamia/syndamiadotcom/-/blob/0510e29526c6d7681587fff4c98a339e8c69e9b5/src/blog/connect-to-mysql-in-csharp-ef/article.md this]. +Also, [url https://www.nuget.org/packages/MySql.Data.EntityFrameworkCore/ MySql.Data.EntityFrameworkCore] has been [=depricated=] since [*October 2020*]. If you need setup instructions with it, read [url https://gitlab.com/Syndamia/syndamiadotcom/-/blob/0510e29526c6d7681587fff4c98a339e8c69e9b5/src/blog/connect-to-mysql-in-csharp-ef/article.md this]. ## NuGet packages -You'll need to install [url https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/ Pomelo.EntityFrameworkCore.MySql]. It provides the stuff necessary for connecting and using a `[MySql]` database. +You'll need to install [url https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/ Pomelo.EntityFrameworkCore.MySql]. It provides the stuff necessary for connecting and using a [`MySql`] database. ## Connection string @@ -30,29 +30,29 @@ There are [url https://www.connectionstrings.com/mysql/ a lot] of ways to setup ``` "server=localhost; port=YOUR-PORT; user id=YOUR-USER-ID; password=YOUR-PASSWORD; database=NAME-OF-DATABASE; SslMode=none" -If you are using `[MySQL Workbench]` and you don't know your port and id, you can look at the server information from the `[MySQL Connections]` page. +If you are using [`MySQL Workbench`] and you don't know your port and id, you can look at the server information from the [`MySQL Connections`] page. [image ./img/connections.png MyServer root 127.0.0.1:3306] In this example, the user id is _root_ and the port is _3306_. ## Connecting -To connect, you'll need to call the `[UseMySql]` method, either in [url #asp.net-startup ASP.NET Startup] or in a [url #dbcontext-child-class DBContext child class]. +To connect, you'll need to call the [`UseMySql`] method, either in [url #asp.net-startup ASP.NET Startup] or in a [url #dbcontext-child-class DBContext child class]. -The method requires at least two arguments: connection string and `[MySql]` server version. The latter you can find, by going to the `[Help/About Workbench]` window inside `[MySQL Workbench]`. +The method requires at least two arguments: connection string and [`MySql`] server version. The latter you can find, by going to the [`Help/About Workbench`] window inside [`MySQL Workbench`]. [image ./img/about-workbench.png] [image ./img/workbench-version.png] -For the server version argument, create a new object of type `[MySqlServerVersion]` and give it's constructor a new object of type `[Version]`, to which you give the version numbers. The result should look something like this: +For the server version argument, create a new object of type [`MySqlServerVersion`] and give it's constructor a new object of type [`Version`], to which you give the version numbers. The result should look something like this: ```c# .UseMySql(CONNECTION_STRING, new MySqlServerVersion(new System.Version(8, 0, 21))) -Where `[CONNECTION_STRING]` is a (constant) variable that contains your connection string, and 8, 0, 21 are the version numbers. +Where [`CONNECTION_STRING`] is a (constant) variable that contains your connection string, and 8, 0, 21 are the version numbers. ### ASP.NET Startup -For `[ASP.NET]` applications, the connection must be put inside the `[ConfigureServices]` method of the `[Startup.cs]` file. If you already have a `[.UseSQL]` method call in there, just replace it with your `[.UseMySql]` method and arguments. +For [`ASP.NET`] applications, the connection must be put inside the [`ConfigureServices`] method of the [`Startup.cs`] file. If you already have a [`.UseSQL`] method call in there, just replace it with your [`.UseMySql`] method and arguments. The result should look something along the lines of: @@ -69,7 +69,7 @@ public void ConfigureServices(IServiceCollection services) ### DBContext child class -Another way to connect is via a `[DBContext]` child class (so, inside your own DB context). Just, override the `[OnConfiguring]` method and call the `[.UseMySql]` method from the `[optionsBuilder]` parameter. +Another way to connect is via a [`DBContext`] child class (so, inside your own DB context). Just, override the [`OnConfiguring`] method and call the [`.UseMySql`] method from the [`optionsBuilder`] parameter. ```c# protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) diff --git a/src/blog/disable-sticky-keys-popup/index.du b/src/blog/disable-sticky-keys-popup/index.du index 4826ea7..a51a7a1 100644 --- a/src/blog/disable-sticky-keys-popup/index.du +++ b/src/blog/disable-sticky-keys-popup/index.du @@ -5,27 +5,27 @@ 'define edited 01 November 2021 [$pagenav] -We've all been there: you're playing a game and after pressing `[Shift]` multiple times, you get a popup about "Sticky Keys", similar to this one: +We've all been there: you're playing a game and after pressing [`Shift`] multiple times, you get a popup about "Sticky Keys", similar to this one: [image ./img/windows-sticky-keys-prompt.png] This is how to stop the popup from showing up ever again: :ordered -1. Press =[Windows key + R]=, type in `[control access.cpl]`, and then press =[OK]= +1. Press [=Windows key + R=], type in [`control access.cpl`], and then press [=OK=] [image ./img/windows-run-control-access.png] -2. Inside the opened up window, press =[Make the keyboard easier to use]= +2. Inside the opened up window, press [=Make the keyboard easier to use=] [image ./img/windows-make-keyboard-highlighted.png] -3. After that, press =[Set up Sticky Keys]= +3. After that, press [=Set up Sticky Keys=] [image ./img/windows-sticky-keys-highlighted.png] -4. Uncheck the =[Turn on Sticky Keys when SHIFT is pressed five times]= +4. Uncheck the [=Turn on Sticky Keys when SHIFT is pressed five times=] [image ./img/windows-sticky-keys-disable.png] -5. Finally, press =[OK]= and close the window +5. Finally, press [=OK=] and close the window diff --git a/src/blog/encrypted-email/index.du b/src/blog/encrypted-email/index.du index 8051eb5..4ed85d7 100644 --- a/src/blog/encrypted-email/index.du +++ b/src/blog/encrypted-email/index.du @@ -29,25 +29,25 @@ When you try and look around for articles, regarding encrypted emails, all you'l That's why, after a fairly lengthy research process, I've decided to do just that. These are the more common ways to encrypt your email with their strengths and weaknesses. I also wrote a (somewhat rough) [url /blog/how-to-encrypt-email tutorial on how to setup] [url #openpgp OpenPGP] or [url #smime S/MIME] in practice. -*[Note:]* What I'm referring to is end-to-end encryption, where you send an encrypted email, and the recipient decrypts it. Encryption between you and a mail server is practically a given and is setup by the mail server administrator. +[*Note:*] What I'm referring to is end-to-end encryption, where you send an encrypted email, and the recipient decrypts it. Encryption between you and a mail server is practically a given and is setup by the mail server administrator. ## Encryption and signature Unless stated otherwise, all of the listed encryption (and signature) schemes work by utilizing [url https://en.wikipedia.org/wiki/Public-key_cryptography public-key cryptography]. -In brief, if you are sending an encrypted email, the =[recipient]= needs to have generated a public and private key pair. Then you need to have acquired =[their public key]=. Finally, if you want to send them an encrypted email: +In brief, if you are sending an encrypted email, the [=recipient=] needs to have generated a public and private key pair. Then you need to have acquired [=their public key=]. Finally, if you want to send them an encrypted email: .numbered -1. You encrypt =[your]= email with =[their public key]= -2. The recipient decrypts =[your]= message with =[their private key]= +1. You encrypt [=your=] email with [=their public key=] +2. The recipient decrypts [=your=] message with [=their private key=] -And if someone wants to send =[you]= an encrypted email, =[you]= need to generate a public and private key pair, share =[your public key]= with them, and when you receive the message, decrypt it with =[your private key]=. +And if someone wants to send [=you=] an encrypted email, [=you=] need to generate a public and private key pair, share [=your public key=] with them, and when you receive the message, decrypt it with [=your private key=]. Every email you send can be [url https://en.wikipedia.org/wiki/Digital_signature digitally signed] (not to be confused with [url https://en.wikipedia.org/wiki/Digital_signature electronic signatures]), meaning the message is (cryptographically) "signed", and with this signature, the recipient can check if the message was changed during transit. Digital signatures also use public-key cryptography, but the other way around: .numbered -1. You sign =[your]= email with =[your private key]= -2. Then the recipient verifies =[your]= message with =[your public key]=. +1. You sign [=your=] email with [=your private key=] +2. Then the recipient verifies [=your=] message with [=your public key=]. This might sound a bit complicated, but all you need to worry about is you and the recipient generating these public-private key pairs, exchanging public keys, and your email client should handle the rest. And if you use a tool like [url https://www.pep.security/en/ pEp], the creation and exchange of keys can be easily automated. @@ -101,7 +101,7 @@ Unlike OpenPGP it doesn't use a web of trust, but a [url https://en.wikipedia.or So, already, it has a huge advantage, you don't need to exchange keys, since the email client will handle it. S/MIME is most often used by corporations/organizations, so support in commercial mail clients like [url https://support.google.com/a/answer/6374496?hl=en#zippy= Google Workspace Enterprise Edition] and [url https://support.microsoft.com/en-us/office/encrypt-messages-by-using-s-mime-in-outlook-on-the-web-878c79fc-7088-4b39-966f-14512658f480 Outlook Enterprise/Business] ([url https://docs.microsoft.com/en-us/exchange/security-and-compliance/smime-exo/configure-smime-exo?view=o365-worldwide Exchange Online has to be configured] by an administrator and can be used only with [url https://docs.microsoft.com/en-us/deployoffice/endofsupport/microsoft-365-services-connectivity paid clients]) is available. -On the other hand, you can browse [url https://support.google.com/a/answer/7448393?hl=en&ref_topic=9061730 Google's] and [url https://docs.microsoft.com/en-us/security/trusted-root/participants-list Microsoft's] trusted (root) CAs all you want, but you'll find that there is only one place where you could register a certificate for free: [url https://www.actalis.com/s-mime-certificates.aspx Actalis]. A good tutorial on the procedure can be found [url https://www.dannyguo.com/blog/how-to-get-a-free-s-mime-certificate/ here], but beware, *[they]* generate the private key. +On the other hand, you can browse [url https://support.google.com/a/answer/7448393?hl=en&ref_topic=9061730 Google's] and [url https://docs.microsoft.com/en-us/security/trusted-root/participants-list Microsoft's] trusted (root) CAs all you want, but you'll find that there is only one place where you could register a certificate for free: [url https://www.actalis.com/s-mime-certificates.aspx Actalis]. A good tutorial on the procedure can be found [url https://www.dannyguo.com/blog/how-to-get-a-free-s-mime-certificate/ here], but beware, [*they*] generate the private key. Otherwise, it's email encryption capabilities are the same as those outlined in [url #pgpmime PGP/MIME]. @@ -129,7 +129,7 @@ projects to create alternatives to email that are more secure yet still email-li And outline zero trust and fingerprinting as the main advantages of these systems. Also most of these systems are [url https://en.wikipedia.org/wiki/Peer-to-peer peer-to-peer]. -Given that these projects aren't really email, I won't dive much deeper into it. But I will mention, almost all listed projects seem to have been abandoned. Those still under active development are [url http://goldbug.sourceforge.net/ goldbug] and [url https://retroshare.cc/ retroshare]. Until 2021, zeronet *[was]* updated, but the [url https://github.com/shortcutme author] seems to have [url https://github.com/HelloZeroNet/ZeroNet/issues/2808#issuecomment-1132820787 disappeared]. +Given that these projects aren't really email, I won't dive much deeper into it. But I will mention, almost all listed projects seem to have been abandoned. Those still under active development are [url http://goldbug.sourceforge.net/ goldbug] and [url https://retroshare.cc/ retroshare]. Until 2021, zeronet [*was*] updated, but the [url https://github.com/shortcutme author] seems to have [url https://github.com/HelloZeroNet/ZeroNet/issues/2808#issuecomment-1132820787 disappeared]. ## Centralized non-email systems @@ -157,13 +157,13 @@ Protonmail, or [url https://proton.me/ proton.me] as they are called now, which Funnily enough, Protonmail doesn't really fit in any of the listed categories, since encrypted emails outside the system will work as any [url #openpgp OpenPGP] encrypted one. -Protonmail's services have a free tier, which should be enough for lighter usage, but restricts =[heavily]= storage, label and folder count, amount of sent messages per day, etc. At the time of writing, their second tier pretty much lifts all restrictions for 5 euro per month (without annual contracts). Check out their pricing [url https://proton.me/pricing here]. +Protonmail's services have a free tier, which should be enough for lighter usage, but restricts [=heavily=] storage, label and folder count, amount of sent messages per day, etc. At the time of writing, their second tier pretty much lifts all restrictions for 5 euro per month (without annual contracts). Check out their pricing [url https://proton.me/pricing here]. ### Tutanota [url https://tutanota.com/ Tutanota] uses it's own special system for security. In brief, all of your emails are (zero-access) stored and end-to-end encrypted with (mostly) [url https://en.wikipedia.org/wiki/Advanced_Encryption_Standard AES 128], and while they generate and hold your public and private keys, your password is needed to decrypt your private key (do check out their [url https://tutanota.com/security/ security page] for more details). -However, it's crucial to note that they are a type *[2. Semi-closed system]*. If you send an encrypted email to a non-tutanota recipient, the recipient will get a URL from which they will be able to reply, through Tutanota's web client. +However, it's crucial to note that they are a type [*2. Semi-closed system*]. If you send an encrypted email to a non-tutanota recipient, the recipient will get a URL from which they will be able to reply, through Tutanota's web client. Finally, pricing. In general, they have a lot less features than [url #protonmail Protonmail], but their free tier is a lot more capable than [url #protonmail Protonmail]'s. Their pricing is extremely flexible, being able to buy specific features by themselves, like storage or mail aliases. Check it out [url https://tutanota.com/pricing/ here]. diff --git a/src/blog/export-skype/index.du b/src/blog/export-skype/index.du index b9046b2..9f88ce7 100644 --- a/src/blog/export-skype/index.du +++ b/src/blog/export-skype/index.du @@ -22,47 +22,47 @@ Continue reading for the required steps on doing it. .unordered - You could be asked to sign in. - After signing in you'll need to *[open the link again]*, since you would be redirected to the wrong place. + After signing in you'll need to [*open the link again*], since you would be redirected to the wrong place. 2. After opening the link you should be greeted by something like this. - Check the two checkboxes next to =[Conversations]= and =[Files]= *[(pointed to by the red arrows)]*. + Check the two checkboxes next to [=Conversations=] and [=Files=] [*(pointed to by the red arrows)*]. [image ./img/initial-screen.png] -3. Press =[Submit request]=. - After being greeted by this screen, press =[Continue]=. +3. Press [=Submit request=]. + After being greeted by this screen, press [=Continue=]. [image ./img/export-prepared.png] .bulleted - - You should now see an =[Available exports]= section near the top of the page. - The status will be =[Pending]=. + - You should now see an [=Available exports=] section near the top of the page. + The status will be [=Pending=]. .p [image ./img/available-exports.png] -5. Reload the page after a bit of time. When your export is ready, you'll find a =[Download]= button next to it, click it. +5. Reload the page after a bit of time. When your export is ready, you'll find a [=Download=] button next to it, click it. [image ./img/download-button.png] -Your export will be downloaded as a `[.tar]` archive file. -You'll need an archiver utility to extract the files, something like [url https://www.rarlab.com/download.htm WinRAR] or [url https://www.7-zip.org/ 7-Zip] *[(I personally recommend 7-Zip, it is completely free (no need to worry about your [url https://youtu.be/fTgZRVVr3_Y infinite trial]) and works faster)]*. +Your export will be downloaded as a [`.tar`] archive file. +You'll need an archiver utility to extract the files, something like [url https://www.rarlab.com/download.htm WinRAR] or [url https://www.7-zip.org/ 7-Zip] [*(I personally recommend 7-Zip, it is completely free (no need to worry about your [url https://youtu.be/fTgZRVVr3_Y infinite trial]) and works faster)*]. ## Viewing your export - Official Tool :ordered 1. Extract your archive -2. Open the [url https://go.skype.com/skype-parser Skype Parser Download], which will prompt you to save `[skype-parser.zip]` +2. Open the [url https://go.skype.com/skype-parser Skype Parser Download], which will prompt you to save [`skype-parser.zip`] -3. Extract `[skype-parser.zip]` +3. Extract [`skype-parser.zip`] -4. Inside the `[skype-parser]` folder, open `[index.html]` (it might be named just `[index]`). You'll be greeted by this page in your browser: +4. Inside the [`skype-parser`] folder, open [`index.html`] (it might be named just [`index`]). You'll be greeted by this page in your browser: [image ./img/default-skype-parser-index.png] -5. Click the `[Choose File]` option and select the `[messages.json]` (it might be named just `[messages]`) file from your export. +5. Click the [`Choose File`] option and select the [`messages.json`] (it might be named just [`messages`]) file from your export. [image ./img/choose-file.png] -6. Press the `[Load]` button right below, and you're done. +6. Press the [`Load`] button right below, and you're done. On the left side you have your conversations, and when opening one, your messages will be displayed to the right (just like in Skype itself) [image ./img/archived-conversations-skype-default.png] @@ -78,11 +78,11 @@ The fix is using an alternative to the official tool. Their source code can be found over at [url https://github.com/ArtemVeremienko/skype-parser github.com/ArtemVeremienko/skype-parser]. :ordered -1. Go to the [url https://github.com/ArtemVeremienko/skype-parser/releases/latest latest release of his skype-parser] and download `[skype-parser.zip]` +1. Go to the [url https://github.com/ArtemVeremienko/skype-parser/releases/latest latest release of his skype-parser] and download [`skype-parser.zip`] [image ./img/github-skype-parser-download.png] 2. Extract all of the files. - They'll be in the same folder as the `[skype-parser.zip]` file, so find the `[index.html]` file and open it. + They'll be in the same folder as the [`skype-parser.zip`] file, so find the [`index.html`] file and open it. 3. Continue from step 5 onward of the [url #viewing-your-export-official-tool Viewing your export - Official Tool] section diff --git a/src/blog/fix-network-brother-printers/index.du b/src/blog/fix-network-brother-printers/index.du index c6ac699..045bb39 100644 --- a/src/blog/fix-network-brother-printers/index.du +++ b/src/blog/fix-network-brother-printers/index.du @@ -10,19 +10,19 @@ Before we start, make sure you have CUPS and avahi installed and running. ## Make sure CUPS recognises it Go to [url https://localhost:631/printers/ localhost:631/printers] and make sure your printer is listed there. -If =[not]=, go to `[Administration/Add Printer]` and select your printer. -If it's =[not]= listed even there, then you have some other network connectivity issue. +If [=not=], go to [`Administration/Add Printer`] and select your printer. +If it's [=not=] listed even there, then you have some other network connectivity issue. Otherwise [url #try-to-print-a-test-page try to print a test page]. -### Check if it =[is]= recognised on the network. +### Check if it [=is=] recognised on the network. Execute in the command line: ```bash avahi-browse --all -t -r -There will be a lot of output, but scroll down until you find something *[like]*: +There will be a lot of output, but scroll down until you find something [*like*]: ``` = enp0s25 IPv4 Brother HL-L2350DW series _pdl-datastream._tcp local @@ -30,7 +30,7 @@ hostname = [BRW9C305B9EC83D.local] address = [192.168.0.110] The exact values aren't important, just make sure the part after IPv4 is the model of your printer. -`[address]` is the local printer address, ping it. +[`address`] is the local printer address, ping it. In this example, the command would be: ```bash @@ -38,11 +38,11 @@ ping 192.168.0.110 .bulleted - If the ping is successful, you might also want to put that IP address in your browser. - With the example, you would open the link `[http://192.168.0.110]`. - Your printer =[may]= or =[may not]= support Web Based Management, which would allow you to edit it's setting from the browser. + With the example, you would open the link [`http://192.168.0.110`]. + Your printer [=may=] or [=may not=] support Web Based Management, which would allow you to edit it's setting from the browser. If the page isn't available, don't worry about it. -If output is =[not]= something like `[64 bytes from ...]` (so, if it is `[Destination Host Unreachable]` or ping just hangs, without output), then it's an issue with your network or printer network configuration. +If output is [=not=] something like [`64 bytes from ...`] (so, if it is [`Destination Host Unreachable`] or ping just hangs, without output), then it's an issue with your network or printer network configuration. Make sure the printer is properly connected to the network.\n Otherwise, this shows that your computer has network access to the printer, and all problems are local. @@ -52,7 +52,7 @@ Otherwise, this shows that your computer has network access to the printer, and Go to [url https://www.openprinting.org/printers www.openprinting.org/printers] and enter your model. If it isn't listed then it doesn't work for sure. Alternatively, if it is and the rating [url https://wiki.linuxfoundation.org/openprinting/database/databaseintro#about_the_data isn't "Perfectly"], then read the whole page, in case networking is listed as nonfunctional. -If it =[is]= supported, then: +If it [=is=] supported, then: ### Check if there are drivers available @@ -61,7 +61,7 @@ Run in the command line: ```bash lpinfo -v -If you only get entries like `[network WORD]`, without anything which looks like a URL (URI), then you may not have a working driver. +If you only get entries like [`network WORD`], without anything which looks like a URL (URI), then you may not have a working driver. Make sure you have installed any or tried all of the drivers listed in the printer's [url https://www.openprinting.org/printers www.openprinting.org] page. ## Try to print a test page @@ -73,7 +73,7 @@ After a little while, the "State" should change from "pending" to "processing" ( ### Unable to locate printer "SOMETHING.local" If you also have the error "Unable to locate printer "SOMETHING.local"." (obviously SOMETHING is the exact value you get), then that means the printer is accessed via the domain name "SOMETHING.local". -`[.local]` domains require a special DNS server to be resolved, so inside `[/etc/nsswitch.conf]`, on the line that starts with `[hosts]`, add to it's end the value `[mdns_minimal]`. +[`.local`] domains require a special DNS server to be resolved, so inside [`/etc/nsswitch.conf`], on the line that starts with [`hosts`], add to it's end the value [`mdns_minimal`]. It should look something like: ``` @@ -82,4 +82,4 @@ hosts: files dns mdns_minimal After saving your changes, your printer should pretty quickly start printing the test page, no need to restart anything. .bulleted -- if your printer supports Web Based Management, then you should be able to go open the page `[http://SOMETHING.local]` in your browser and edit your printer settings from there. +- if your printer supports Web Based Management, then you should be able to go open the page [`http://SOMETHING.local`] in your browser and edit your printer settings from there. diff --git a/src/blog/fix-no-frame-buffer-plan9/index.du b/src/blog/fix-no-frame-buffer-plan9/index.du index 4e9c877..8d63c0b 100644 --- a/src/blog/fix-no-frame-buffer-plan9/index.du +++ b/src/blog/fix-no-frame-buffer-plan9/index.du @@ -14,7 +14,7 @@ init: rc exit status: rio 31: display open [image ./img/boot-prompt-no-frame-buffer-error.png] -For some reason, on certain configurations, the `[xga]` (`[vga]`) monitor type does not work when booting into Plan 9, even though it works fine during install. The fix is to adjust monitor settings to `[vesa]`: +For some reason, on certain configurations, the [`xga`] ([`vga`]) monitor type does not work when booting into Plan 9, even though it works fine during install. The fix is to adjust monitor settings to [`vesa`]: :ordered 1. In the shell prompt enter @@ -62,12 +62,12 @@ sam /n/9fat/plan9.ini b /n/9fat/plan9.ini and click the green-backgrounded box. - Then replace `[xga]` with `[vesa]`: + Then replace [`xga`] with [`vesa`]: ``` , x/xga/ s/xga/vesa - and click the green-backgrounded box again. We're almost done here, enter `[w]`, wait a bit, and finally enter `[q]`. + and click the green-backgrounded box again. We're almost done here, enter [`w`], wait a bit, and finally enter [`q`]. :unordered - If you want to check whether the file was properly saved, feel free to run @@ -79,10 +79,10 @@ cat /n/9fat/plan9.ini [image ./img/rio-plan9ini-cat.png] - - The first command opens the `[plan9.ini]` file for editing, and the second command, finds every line that contains `[xga]` (there should probably be only one) and on each matching line replaces `[xga]` with `[vesa]`. Refer to the [url https://p9f.org/sys/doc/sam/sam.html docs] for more information. + - The first command opens the [`plan9.ini`] file for editing, and the second command, finds every line that contains [`xga`] (there should probably be only one) and on each matching line replaces [`xga`] with [`vesa`]. Refer to the [url https://p9f.org/sys/doc/sam/sam.html docs] for more information. -5. That's it, all we have to do is halt our file system with `[fshalt]` (or type out the command in the [url https://9p.io/wiki/plan9/Installing_Plan_9_on_Qemu/ Qemu installation guide]) and Force Reset the virtual machine. +5. That's it, all we have to do is halt our file system with [`fshalt`] (or type out the command in the [url https://9p.io/wiki/plan9/Installing_Plan_9_on_Qemu/ Qemu installation guide]) and Force Reset the virtual machine. The next time you boot into Plan 9 and into your user, the graphical environment should load fine. Enjoy Plan 9! diff --git a/src/blog/fix-qc-timeout/index.du b/src/blog/fix-qc-timeout/index.du index d882d15..11dfa32 100644 --- a/src/blog/fix-qc-timeout/index.du +++ b/src/blog/fix-qc-timeout/index.du @@ -6,7 +6,7 @@ [$pagenav] Depending on your harddrive, you may get a 15 second delay on boot. -Looking at the kernel logs (with `[dmesg]`), you may find the following errors: +Looking at the kernel logs (with [`dmesg`]), you may find the following errors: ``` kernel: ata1.00: qc timeout after 15000 msecs (cmd 0x47) @@ -23,7 +23,7 @@ Meaning, add the following parameter: ``` libata.force=1.00:nodmalog -where `[1.00]` is the thing between "ata" and ":". +where [`1.00`] is the thing between "ata" and ":". So, if your logs were @@ -68,16 +68,16 @@ With DMA, the CPU could ask the drive for everythng it wants (not a tiny bit), a The benefit is that the CPU can do other work while the transfer is going on, greatly improving efficiency, but the downside is that the harddrive has to support it (have a DMAC chip on it). Normally it would be useful for the DMAC to keep logs in a special place on the drive. -~[This is where the issue comes from: your harddrive supports DMA but does not support logs for it. +[~This is where the issue comes from: your harddrive supports DMA but does not support logs for it. However, the Linux kernel has no good way of knowing that, there is no "property" on the drive which tells us this. -The only way is to try and read from that log: if it succeeds, then there is support, if it fails, then there isn't.]~ +The only way is to try and read from that log: if it succeeds, then there is support, if it fails, then there isn't.~] -~[But what does it mean to fail? +[~But what does it mean to fail? The simplest definition would be for the drive to return an error singal, but in our case, the drive would just not return anything, ignoring our request. In that case, how would we know if the drive just doesn't know how to respond (meaning it doesn't support the logs) or if it's just very slow? -Well, we can't, so we put a time limit, if it doesn't respond in 15 seconds, then it probably doesn't support it.]~ +Well, we can't, so we put a time limit, if it doesn't respond in 15 seconds, then it probably doesn't support it.~] -That's what the error is saying: `[qc]` is short for [url https://docs.kernel.org/driver-api/libata.html#origins-of-commands "queued command"], it's used to represent a (S)ATA command (hence the `[cmd]` at the end, telling us which command it's referring to). +That's what the error is saying: [`qc`] is short for [url https://docs.kernel.org/driver-api/libata.html#origins-of-commands "queued command"], it's used to represent a (S)ATA command (hence the [`cmd`] at the end, telling us which command it's referring to). So, the kernel is telling us "The hard drive (ATA) command to read (DMA) logs timed out after 15 seconds" (it first says a command timed out, then it says which one). By adding that kernel parameter, we're telling Linux that the drive doesn't support DMA logs, therefore the kernel doesn't need to do this "wait 15 seconds for response if support exists" routine. diff --git a/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/balove-2021.du b/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/balove-2021.du index 9f98e46..0796818 100644 --- a/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/balove-2021.du +++ b/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/balove-2021.du @@ -5,7 +5,7 @@ 'define edited 14 July 2023 [$pagenav] -*[Тази страница е разширение на [url ./ "ФМИ и висшето образование в програмистката индустрия"].]* +[*Тази страница е разширение на [url ./ "ФМИ и висшето образование в програмистката индустрия"].*] Благодарение на електронната система за кандидатстване, имам минимални балове на трите класирания през 2021 за компютърни науки, софтуерно инженерство и информатика (без информационни системи, защото не исках да влизам там). Понеже такава информация много не се разпространява, тук ще я споделя подробно. @@ -19,9 +19,9 @@ Балът се формираше така: .bulleted -- 3 по оценката от Математика II *[или]* 2.5 по оценката от Математика I (което от двете носи по-голямо число) +- 3 по оценката от Математика II [*или*] 2.5 по оценката от Математика I (което от двете носи по-голямо число) - + -- ако си ходил на държавен зрелостен изпит по математика, оценката от него, *[иначе]* оценката по математика от дипломата +- ако си ходил на държавен зрелостен изпит по математика, оценката от него, [*иначе*] оценката по математика от дипломата За някакво усещане за баловете, ще напиша минималната нужна оценка от изпитите, считайки оценката от ДЗИ или дипломата за 6,00. Ако балът е под 13.5, то тогава със сигурност са приети студенти, които са имали по-малко от 6.00 на ДЗИ/диплома и са компенсирали с резултати на изпитите по математика (не може да кандидатстваш с оценка, по-ниска от 3.000). @@ -67,7 +67,7 @@ |: 3.877 |: Информатика - платено редовно -|: *[11.62]* +|: [*11.62*] |: 3.000 |: 3.000 @@ -91,7 +91,7 @@ |: 4.263 |: Информатика - редовно -|: *[10.64]* +|: [*10.64*] |: 3.000 |: 3.000 @@ -135,7 +135,7 @@ |: 4.406 |: Информатика - редовно -|: *[12.00]* +|: [*12.00*] |: 3.000 |: 3.000 diff --git a/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/index.du b/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/index.du index 3b13c4c..ec2f9b8 100644 --- a/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/index.du +++ b/src/blog/fmi-i-vissheto-obrazovanie-v-programistkata-industriq/index.du @@ -51,7 +51,7 @@ Аз вече съм следвал 2 години в университет, плюс това имам сериозен опит от преди това. Макар и този блогпост да е главно за [url https://www.fmi.uni-sofia.bg/ Факултета по Математика и Информатика] към [url https://www.uni-sofia.bg/index.php Софийски Университет], по-общата ми цел е да споделя всичко , което знам свързано с образованието в индустрията. -Бърза бележка: всичко казано =[важи за моя випуск]=, с времето нещата се изменят и може повечето информация тук да бъде =[остаряла]=. +Бърза бележка: всичко казано [=важи за моя випуск=], с времето нещата се изменят и може повечето информация тук да бъде [=остаряла=]. Допълнително, [url ./balove-2021.html тук] имам изкарани баловете във ФМИ (на СУ) за 2021 година. ## Кой съм аз @@ -126,7 +126,7 @@ Във ФМИ много от предметите са математики и програмиранията се говори, че не са много добре. Онлайн има стотици часове материали и курсове, повечето от които са безплатни, на всяка тема свързана с програмиране. -Допълнително имаш [url https://www.telerikacademy.com/ Telerik Academy] и [url https://softuni.bg/ SoftUni] (само искам да напомня, че =[СофтУни не е университет]=, макар и така да се казват) - две места които предлагат разнообразни програмистки и чисто практически курсове (и също дават сертификати). +Допълнително имаш [url https://www.telerikacademy.com/ Telerik Academy] и [url https://softuni.bg/ SoftUni] (само искам да напомня, че [=СофтУни не е университет=], макар и така да се казват) - две места които предлагат разнообразни програмистки и чисто практически курсове (и също дават сертификати). А и повечето програмисти нямат висше и са самоуки, тоест този път не е изобщо странен, даже е най-често следвания. Финалното ми мнение се намира [url #section-19 най-долу], но един такова решение трябва да се вземе с възможно най-много информация. @@ -138,7 +138,7 @@ От тях, най-желани са компютърни науки и софтуерно инженерство (тези ще наричам "хубавите" специалности). В информатика се влизаше много лесно, там балът беше [url ./balove-2021.html безнадеждно нисък], обаче следването е най-трудно от всички останали дисциплини. -Късането е брутално, особено първи курс: по Алгебра 1 от към 200 човека (това включваше и минали години май) само един човек беше *[допуснат]* до изпит (ама си го мина де). +Късането е брутално, особено първи курс: по Алгебра 1 от към 200 човека (това включваше и минали години май) само един човек беше [*допуснат*] до изпит (ама си го мина де). По дискретни структури бяха повече, цели 10тима човека. Общо от 1ви курс преминаха успешно 20-30 човека във 2ри курс (за да минеш не е нужно всички изпити да си минал, ама детайли [url #section-10 по-късно]). Има няколко причини за това: @@ -174,20 +174,20 @@ Като обобщение, това са дисциплините подредени от най-трудна за минаване към най-лесна: :ordered -1. =[Информатика]=: много трудно, не по много основателни причини, макар че като цяло малцинството което успява да завърши са на високо ниво. +1. [=Информатика=]: много трудно, не по много основателни причини, макар че като цяло малцинството което успява да завърши са на високо ниво. Не препоръчвам, ако не си много издържлив и КН и СИ не са се получили. -2. =[Компютърни науки, 2ри поток]=: трудно, но като цяло е сравнително основателно (пак на моменти е малко нечестно, но не толкова колкото при информатика), нивото просто е високо. +2. [=Компютърни науки, 2ри поток=]: трудно, но като цяло е сравнително основателно (пак на моменти е малко нечестно, но не толкова колкото при информатика), нивото просто е високо. Поне от моя випуск, повечето от най-добрите се намират тук. Ако си представим, че има някакво перфектно ниво на обучение, където не е твърде лесно, но и не е твърде трудно, бих казал че КН2 се намира малко над това ниво. -3. =[Компютърни науки, 1ви поток]=: малко по-лесно от КН2, но с малко понижаване на качеството. +3. [=Компютърни науки, 1ви поток=]: малко по-лесно от КН2, но с малко понижаване на качеството. Има добро количество материал, което в КН2 ти е набито в главата, докато при КН1 си го забравил след лятната ваканция (не че това не важи в обратната посока, но в КН2 ни вкарват повече неща в умовете). В сравнение с перфектното ниво, КН1 е малко под него. Обаче трябва да се има в предвид, че 2ри курс сложиха доста взискателни преподаватели. Ако това се запази, разликата между двата потока може да изчезне. -4. =[Софтуерно инженерство]=: забележимо по-лесно от компютърни науки, повечето хора по повечето дисциплини минават без твърде много проблеми. +4. [=Софтуерно инженерство=]: забележимо по-лесно от компютърни науки, повечето хора по повечето дисциплини минават без твърде много проблеми. Ама нивото също спада забележително, макар и бала да е най-висок. Както споменах, при компютърни науки е по-добре, ама нивото на СИ пак е сравнително ок. -5. =[Информационни системи]=: нисичък бал и сравнително лесно, но не ми изглежда да е супер развиващо за програмисти. +5. [=Информационни системи=]: нисичък бал и сравнително лесно, но не ми изглежда да е супер развиващо за програмисти. Не бих препоръчал, освен ако алтернативата не е информатика. @@ -225,10 +225,10 @@ С новия изпит вече конкуренцията е малко по-висока, все пак са се явили 969[$2022-kandidati] ученици на Математика през 2022 и максимум 979[$2023-kandidati] през 2023. Местата са същия брой, така че излиза към примерно трима човека за едно място и ако примерно имаш 3ка или 4ка може и да не влезеш във ФМИ. -Обаче, =[най-важното: материалът във ФМИ не се е изменил!]= +Обаче, [=най-важното: материалът във ФМИ не се е изменил!=] Макар и изпитът да е значително по-лесен, трудността на материала не се е снижила (или поне толкова, колкото изпита) и в същото време математиката се изучава доста. Тоест, един човек, влязъл с най-ниския бал на Математика ще е далеч по-неподготвен за ФМИ от човек с минимален бал на Математика II. -Затова =[препоръчвам всеки кандидат-студент да може да реши някоя Математика II за към 4-4.50!]= +Затова [=препоръчвам всеки кандидат-студент да може да реши някоя Математика II за към 4-4.50!=] Това са горе-долу 5-6 от 8те задачи. Иначе ако не можеш редовно да учиш математика и не можеш да се справиш с такива задачи (които са по-прости като характер в сравнение с това, което учим в университета), следването ти ще бъде твърде трудно според мен. @@ -253,7 +253,7 @@ Оценката се формира по различни начини при различните предмети, но най-често контролните и домашните през семестъра носят 40-50% и през сесията си изкарваш останалата част от оценката. Също понякога, ако си се справил достатъчно добре на контролните през семестъра, може да бъдеш освободен от изпит-задачи (не е нужно да ходиш и като оценка на него ти се пише средно аритметично от контролните). -Обаче почти винаги =[ако изкараш двойка на някой от изпитите през сесията, цялата ти оценка за предмета става двойка!]= +Обаче почти винаги [=ако изкараш двойка на някой от изпитите през сесията, цялата ти оценка за предмета става двойка!=] 'footnote september Разговорно на поправителната сесия им викаме септември, макар и само един-два дена от нея да са в този месец. Причината е, че просто до преди няколко години наистина е била през септември, но са я изместили назад. Защо са я изместили, не знам. @@ -282,7 +282,7 @@ Количеството подготовка за едно контролно зависи от човек на човек, но ако нищо не си учил, бих казал че е поне една-две интензивни седмици за сериозните предмети са достатъчни. За домашните е по-малко, защото по принцип те са върху неща, изучавани на упражнения, така че ако си си водел записки (или споделящи колеги са водели) ще знаеш как да решиш всички задачи (разбира се, има изключения). -Това обаче е =[само за контролни-задачи по някои предмети]=, все пак имаш теория и имаш задачи за които ти трябва теория, и тя вече не може да се научи толкова бързо. +Това обаче е [=само за контролни-задачи по някои предмети=], все пак имаш теория и имаш задачи за които ти трябва теория, и тя вече не може да се научи толкова бързо. Нещо много хубаво е, че никой не следи за присъствие на занятия и не се пишат отсъствия както в училище. Разбира се, това не означава, че не е нужно да се ходи на всички занятия, напротив, но ако искаш винаги може да пропуснеш нещо. @@ -305,13 +305,13 @@ Обаче, си задължен и да ходиш на избираеми дисциплини: имаш минимален брой избираеми за всеки семестър, минимален общ брой за всичките години и минимален брой ECTS кредити за всичките години. За разлика от училище, имаш доста голям избор и много от тях са интересни и полезни. -Обаче, =[не записвай избираеми през първи курс!]= -Скоро ще обсъдим предметите, обаче =[първи курс е най-труден и изисква цялото ти работно време!]= -Това трябва да навежда на мисълта, че =[не трябва да работиш по време на първи курс]=, освен ако не ти се налага или не си от най-умните хора в специалността. +Обаче, [=не записвай избираеми през първи курс!=] +Скоро ще обсъдим предметите, обаче [=първи курс е най-труден и изисква цялото ти работно време!=] +Това трябва да навежда на мисълта, че [=не трябва да работиш по време на първи курс=], освен ако не ти се налага или не си от най-умните хора в специалността. Материалът е нещо напълно ново, не само като изучавани неща, ами и като концепции и модел на учене. -Ама каквото и да си говорим, =[най-доброто обучение се намира в избираемите дисциплини!]= +Ама каквото и да си говорим, [=най-доброто обучение се намира в избираемите дисциплини!=] Не е задължително да си доцент или професор, за да направиш избираема, и може да я направиш както си искаш. Има много такива, които се водят от бивши студенти на ФМИ, които сега работят в големи компании, и предоставят супер практично и готино обучение. За някои неща даже не можеш да намериш в България курсове, като [url https://intranet.fmi.uni-sofia.bg/index.php/s/uGI4XDReO3WoUok Реализация на езици за програмиране], където се разглежда как се правят компилатори или [url https://intranet.fmi.uni-sofia.bg/index.php/s/v2v4WlP2GdDbWtb Употреба и скриптиране на Vim], където подробно поглежда един от най-добрите текстови редактори някога създавани. @@ -357,7 +357,7 @@ ##### Зимен семестър -=[Алгебра 1]=: пълното име е линейна алгебра. +[=Алгебра 1=]: пълното име е линейна алгебра. Занимава се главно с линейни уравнения (ax + by + ... + mz = k), обаче интересното идва като изследваме операции върху тях и ги навържем в пространства. Много фундаментален предмет, използват се поне части от него в много клони на математиката и инженерството (защото много неща могат да се моделират с нея). Има употреби в machine learning, в компютърната графика, в алгоритми за препоръки (търсачки примерно), обработка на изображения и много други. @@ -365,7 +365,7 @@ Има по една малка задача всяка седмица, но не са трудни, изисква постоянство. Предметът се минава без твърде много трудности, лекционните записки са много прецизно написани и упражненията са супер. -=[Диференциално и интегрално смятане 1]=: с други думи, реален анализ. +[=Диференциално и интегрално смятане 1=]: с други думи, реален анализ. Главно разглеждаме свойства и операции върху функции и редици числа. В училище учим производни; глаголът да правиш производни разговорно може да се нарече "производиране", обаче терминът е диференциране. Интегрирането е обраното действие на диференцирането, тоест намирането на функция, имайки само нейната производна. @@ -376,7 +376,7 @@ Главната цедка е теорията, на която имаш теоретични задачи, при които дори за 3ка ще трябва да приложиш малко усет към предмета. Като цяло просто изискванията са високи, иначе екипа са готини и бих казал, че оценяването е честно. -=[Дискретни структури]=: този предмет е малко смесица от три предмета - булева алгебра, увод в теория на множествата, комбинаторика и теория на графите. +[=Дискретни структури=]: този предмет е малко смесица от три предмета - булева алгебра, увод в теория на множествата, комбинаторика и теория на графите. От всичките математики, това е може би най-важната за програмиране. В определен смисъл на думата, ДИС се занимава с безкрайно много и безкрайно малки елементи: на една функция може да и подадеш числото 1, но и 1.1, и 1.11 и так. нат., без проблем. Обаче ДСТР разглежда дискретни обекти, тоест някакъв краен брой конкретни неща. @@ -397,7 +397,7 @@ Ама трябва да предупредя, че не получаваш точки за половинчати решения, като цяло или си решил задачата коректно или не. Бих казал че при този предмет се появяват нечестности или прекомерно високи изисквания на моменти, но се минава. -=[Увод в програмирането]=, неговото значение трябва да е очевидно. +[=Увод в програмирането=], неговото значение трябва да е очевидно. Изучава се C++, макар и някои неща да не са направени по най-добрите начини. Налага се да знаеш и ползваш точно нещата, които ти се преподават и нищо друго. Не бих казал, че е лошо направен, има някакво основание за тази методика, обаче някои неща се разглеждат твърде формално и програмирането не се изучава като динамичен предмет, в който може да решиш проблеми по много начини, а като задача по математика, където се изисква определено решение. @@ -410,9 +410,9 @@ ##### Летен семестър -=[Диференциално и интегрално смятане 2]=: директно продължение на ДИС1. +[=Диференциално и интегрално смятане 2=]: директно продължение на ДИС1. -=[Геометрия]=: истинското име на този предмет е аналитична геометрия и няма нищо общо с училищната евклидова геометрия. +[=Геометрия=]: истинското име на този предмет е аналитична геометрия и няма нищо общо с училищната евклидова геометрия. Разглеждаме пространствата и геометричните обекти като по-абстрактни неща, или по-конкретно, разглеждаме повече числата и зависимостите между конкретни обекти. Централно в компютърната графика и всичко около нея (обработка на изображения, 3D моделиране, ...). @@ -420,7 +420,7 @@ Упражненията са супер, има и много добри записки по тях. Минава се без твърде много проблеми. -=[Езици, автомати и изчислимост]=: вторият най-важен предмет от математиките, на английски се казва Theoretical Computer Science. +[=Езици, автомати и изчислимост=]: вторият най-важен предмет от математиките, на английски се казва Theoretical Computer Science. Занимава се с различни теоретични обекти, които могат да правят изчисления върху текстови низове. Всичко свързано с анализ или шаблони върху текст използва нещата тук, а пък и отвъд. Ако някога си чувал за машина на Тюринг, Тюринг-завършеност на програмни езици или проблемът за спирането, от тука идват. @@ -430,7 +430,7 @@ И както по дискретни структури, асистентите не са консистентни и нивото малко криви. Ама в края на деня преподавателите са готини и не искат да прецакват хора, така че се минава спокойно. -=[Обектно ориентирано програмиране]=: това е най-популярният начин/парадигма за програмиране. +[=Обектно ориентирано програмиране=]: това е най-популярният начин/парадигма за програмиране. Обект е групиране на данни с функциите върху тях, като са изпълнени [url https://en.wikipedia.org/wiki/Object-oriented_design#Object-oriented_concepts няколко свойства]. Кажи-речи всяка компания и всеки модерен програмен език, който се използва в индустрията, поддържа ООП. @@ -444,7 +444,7 @@ ##### Зимен семестър -=[Компютърни архитектури]=: описание на хардуера. +[=Компютърни архитектури=]: описание на хардуера. Малко се доближава и до електротехниката, но се разглеждат много фундаменталните хардуерни компоненти и техните функционалности в един компютър. Разглеждаме основните компонентни схеми за изчисления и хардуерно как се ползват и работят нещата. Не е кой знае колко полезен за средния програмист, освен ако не се занимаваш със системно програмиране, ама е много важен фундамент. @@ -453,7 +453,7 @@ Това е първият предмет при който няма задължителни упражнения, но никой не препоръчва да се ходи на избираемия практикум, понеже не е координиран много добре с лекциите и някои неща стават твърде трудни. Иначе минаването е лесно. -=[Основи на компютърната графика]=: има ли изобщо какво да обяснявам. +[=Основи на компютърната графика=]: има ли изобщо какво да обяснявам. Разглеждаме част от математиката, но повече се занимаваме с 3D моделиране и идеите на сложните неща, не толкова тяхното имплементиране. Минаването е лесно, трябва да си малко консистентен със седмичните задачи обаче. @@ -461,14 +461,14 @@ Презентациите в които се намира материала са перфектно направени и упражненията са много приятни. Ето [url https://boytchev.github.io/scorm/ тук] има редици малки задачки/игри с които можеше да изкараш малък бонус към оценката. -=[Структури от данни и програмиране]=: нещо като въведение в дизайн и анализ на алгоритмите. +[=Структури от данни и програмиране=]: нещо като въведение в дизайн и анализ на алгоритмите. Занимаваме се с някои много важни структури от данни, като стек и опашка, и разглеждаме алгоритми върху тях. Супер важно за всеки програмист. Екипът пак е същия, както при УП и ООП, така че мнението ми продължава, но тук поне изискванията за писане на код са по-основателни. Все пак разглеждаме конкретни структури от данни и алгоритми, ако не ги ползваш в решенията на задачи, малко би се обезсмислила цялата история. -=[Функционално програмиране]=: втората най-използвана парадигма след ООП. +[=Функционално програмиране=]: втората най-използвана парадигма след ООП. Идеята е, че разглеждаме всичко като функции, във всеки момент една функция връща нещо или приема нещо и никъде не пазим състояния. Тоест, една стойност се намира или като аргумент или като върната стойност. Също супер важно да се знае и може. @@ -478,7 +478,7 @@ ##### Летен семестър -=[Алгебра 2]=: дефакто разглеждаме теория на групите, което на английски съм го виждал и като "Modern algebra". +[=Алгебра 2=]: дефакто разглеждаме теория на групите, което на английски съм го виждал и като "Modern algebra". Група е някакво множество от елементи и операция върху тях, като за операцията са изпълнени няколко свойства. Допълнително имаме и пръстен, където вече имаш множество и две операции върху тях. Може би звучи странно, но е една от [url https://www.youtube.com/watch?v=mH0oCDa74tE най-интересните и шантави математики]. @@ -487,7 +487,7 @@ Екипът същия като при Алгебра 1, така че нямам оплаквания. Макар че този път няма седмични задачи - ура! -=[Дизайн и анализ на алгоритми]=: също едно име, което обяснява себе си. +[=Дизайн и анализ на алгоритми=]: също едно име, което обяснява себе си. Разглеждаме методиките за сравняване на алгоритми (асимптотика) и как да докажем тяхната коректност. Също разглеждаме доста основни и често използвани алгоритми, както и се допираме до [url https://en.wikipedia.org/wiki/NP_%28complexity%29 NP сложност]. Още един много важен предмет. @@ -497,7 +497,7 @@ Обаче смятам, че на доста моменти навлиза твърде много в математиката и теорията, и има същите проблеми с оценяването както по ДСТР. Цели 15 човека минаха от първия път, така че нивото е горе-долу същото. -=[Изследване на операциите]=: решава оптимизационни задачи, тоест задачи при които искаш минимум или максимум, като за всяка променлива имаш някакво ограничение (на английски се казва Linear Programming, но няма нищо общо с програмиране). +[=Изследване на операциите=]: решава оптимизационни задачи, тоест задачи при които искаш минимум или максимум, като за всяка променлива имаш някакво ограничение (на английски се казва Linear Programming, но няма нищо общо с програмиране). Една оптимизационна задача е примерно ако имаме фабрики за автомобили, всяка произвеждаща различно количество коли и складове в други градове, с различни капацитети, и имаме цената на пътя между градовете и складовете, как най-евтно ще пренесем всички автомобили в складовете. Има употреба ако се опитваш да решиш такъв тип задачи, но ми се струва от по-безполезните неща за един програмист. @@ -505,7 +505,7 @@ Лекторът е готин. Минаването е лесно, нещата не са супер трудни. -=[Компютърни мрежи]=: пак име, което само се обяснява. +[=Компютърни мрежи=]: пак име, което само се обяснява. Абсолютно всичко свързано с интернет и мрежите, от протоколи до методи за маршрутизация. Като КАРХ не е от най-полезните за ежедневието, но е много важен фундамент. @@ -513,7 +513,7 @@ Както и по други предмети, лектора не иска да ни прецаква, затова минаването не е проблем. Даже бих казал, че е твърде лесно. -=[Операционни системи]=: може би най-важният не-математически предмет, ако беше направен свестно. +[=Операционни системи=]: може би най-важният не-математически предмет, ако беше направен свестно. Имам много силно мнение за него, като цяло предмета се свежда до 70% менижиране на процеси, 20% менижиране на памет и 10% случайни неща. Имаше потенциалът да е от най-добрите предмети в целия бакалавър, ама програмата и изпитването беше наистина зле направено. @@ -539,4 +539,4 @@ 2. Студентстването като изживяване е веднъж в живота, все пак характерът става по-издържлив когато те скъсат по няколко изпита, за които си учил много. 3. Каквото и да си говорим, ФМИ е доста авторитетно учебно заведение, макар и диплома за един програмист да не е задължителна, със сигурност ще помогне значително. -И даже бих аргументирал, че е =[по-добре да следваш една година във ФМИ и да се откажеш, отколкото да следваш 4 години и да завършиш в който и да е друг университет!]= +И даже бих аргументирал, че е [=по-добре да следваш една година във ФМИ и да се откажеш, отколкото да следваш 4 години и да завършиш в който и да е друг университет!=] diff --git a/src/blog/friendship-ended-with-funtoo-now-gentoo-is-my-best-friend/index.du b/src/blog/friendship-ended-with-funtoo-now-gentoo-is-my-best-friend/index.du index 783050b..1c6d67b 100644 --- a/src/blog/friendship-ended-with-funtoo-now-gentoo-is-my-best-friend/index.du +++ b/src/blog/friendship-ended-with-funtoo-now-gentoo-is-my-best-friend/index.du @@ -24,18 +24,18 @@ Here is what happened. Before we begin, I want to take a second and explain some Gentoo/Funtoo terminology: :unordered -- `[emerge]` (as a verb): what does "install" mean? I would argue it means copying a program and the file it depends on somewhere on a system, with the goal of being able to run this program. +- [`emerge`] (as a verb): what does "install" mean? I would argue it means copying a program and the file it depends on somewhere on a system, with the goal of being able to run this program. .p Now, in Gentoo and Funtoo, most programs are compiled from source code, so before you install you download it's source and compile. - For this reason, on such systems you would usually say a certain program/package is *[being emerged, not installed]* (and the words comes from the [url https://wiki.gentoo.org/wiki/Emerge package-manager command-line utility of the same name]). + For this reason, on such systems you would usually say a certain program/package is [*being emerged, not installed*] (and the words comes from the [url https://wiki.gentoo.org/wiki/Emerge package-manager command-line utility of the same name]). -- `[ebuild]` (file): the exact steps needed to emerge a package differ from one project to another, but how do you manage packages then? +- [`ebuild`] (file): the exact steps needed to emerge a package differ from one project to another, but how do you manage packages then? The solution is that when you try to emerge something, a special file with detailed instructions is looked up: an ebuild file. - repository tree: the collection of all ebuilds -- `[use]` flags: every program can be built with different flags (aka options), which enable or disable certain features from being available in the result package. +- [`use`] flags: every program can be built with different flags (aka options), which enable or disable certain features from being available in the result package. For example, the text editor [url https://packages.gentoo.org/packages/app-editors/vim vim] supports sound, but not everyone would want to have that feature. @@ -49,18 +49,18 @@ Most packages and their dependencies on Funtoo go unmaintained and untested for Python was stuck at version 3.7, while a lot of packages like barrier, libplacebo, mpv and pulseeffects[$packages-in-repo-tree] required[$required-3.8] at least 3.8. So, with a lot of effort and poking around, I got python 3.8 to work, just barely. -What's even better is that eventually I reached an =[unfixable]= circular python dependency (between dev-python/packaging and dev-python/setuptools). +What's even better is that eventually I reached an [=unfixable=] circular python dependency (between dev-python/packaging and dev-python/setuptools). 'footnote glibc This point may not be completely fair, since Funtoo has a system for [url https://web.archive.org/web/20230528115518/https://projects.funtoo.org/metatools/docs/autogen.html ebuild generation], which means that they might've made configuration changes and/or applied patches which "fix" that version, but still, it really isn't a good look. -Another problem child was glibc, it is *[currently]* at [url https://github.com/funtoo/core-kit/tree/1.4-release/sys-libs/glibc version 2.33-r2], which under Gentoo [url https://gitweb.gentoo.org/repo/gentoo.git/tree/profiles/package.mask#n542 is officially masked and discouraged for usage][$glibc] and wouldn't you know it, also prevents some packages from being compiled (mainly I remember ungoogled-chromium). +Another problem child was glibc, it is [*currently*] at [url https://github.com/funtoo/core-kit/tree/1.4-release/sys-libs/glibc version 2.33-r2], which under Gentoo [url https://gitweb.gentoo.org/repo/gentoo.git/tree/profiles/package.mask#n542 is officially masked and discouraged for usage][$glibc] and wouldn't you know it, also prevents some packages from being compiled (mainly I remember ungoogled-chromium). There were a lot more problematic packages, but I've forgotten most details. What I do remember is that the day I decided to hop to Gentoo, I tried to update my system and yet again I got some sort of issue, either a package couldn't compile properly or there was some dependency conflict. That was preceded by my unsuccessful attempts at getting the kicad package to work a couple of days prior. At that point, this had become completely normal. -=[But]= Funtoo shouldn't be blamed for it! +[=But=] Funtoo shouldn't be blamed for it! ## I didn't follow the wolf pack philosophy @@ -68,20 +68,20 @@ On the [url https://www.funtoo.org/Welcome Welcome] page of Funtoo's website, in This is essentially a document describing how a member of the community should behave, and I didn't follow it. Any member of the pack is supposed to: .unordered -- =[Be Mindful of the Pack]= by tackling challenges with the community\n +- [=Be Mindful of the Pack=] by tackling challenges with the community\n but as I found (package) challenges, I tackled them on my own, not trying to consult anyone or ask for help -- =[Be Interconnected]= by supporting and being supported by the community\n +- [=Be Interconnected=] by supporting and being supported by the community\n but I didn't connect with anyone on my issues -- =[Howl]= by expressing their needs and sharing their "adventures"\n +- [=Howl=] by expressing their needs and sharing their "adventures"\n but I didn't express them and didn't share the work I've done Or more simply put, Funtoo is a small project, and you need to communicate with others to get things done. 'footnote kicad On that aforementioned kicad package, drobbins, the benevolent dictator for life of Funtoo, categorized it as a [url https://bugs.funtoo.org/browse/FL-8435?focusedId=52907&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-52907 package which people aren't interested in]. -Another way to look at it is that in a project of this scale, what gets supported is what the community uses, so in a way, I was trying to use Funtoo in the *[wrong]* way. +Another way to look at it is that in a project of this scale, what gets supported is what the community uses, so in a way, I was trying to use Funtoo in the [*wrong*] way. This may sound ridiculous, but then again, they aren't making a project which "just works" for everyone (like Ubuntu or Linux Mint), this is a project by the community for the community. -You can't expect them to support everything that a big-scale distro does, like Gentoo, with a fraction of the manpower, so if nobody supports a package (which exists in the repository tree) that doesn't work and you don't at least speak up, it will probably stay broken[$kicad] (this kind of relates to the =[Is Territorial]= point in the philosophy). +You can't expect them to support everything that a big-scale distro does, like Gentoo, with a fraction of the manpower, so if nobody supports a package (which exists in the repository tree) that doesn't work and you don't at least speak up, it will probably stay broken[$kicad] (this kind of relates to the [=Is Territorial=] point in the philosophy). However, in my defense, I didn't open bug reports or create forum posts because my issues weren't "directly" related to Funtoo, or a normal Funtoo installation. Most of the time I would have an issue with a package, then get it's Gentoo counterpart, try to get all dependencies working one by one, and it will fail with some unsearchable error. @@ -146,8 +146,8 @@ Unfortunately, for Gentoo it's the opposite effect, I couldn't compile most pack .quote package.use > make.conf -There is a big emphasis on writing your use flags in a separate `[/etc/portage/package.use]` file (or make it a folder and add use flags in different subfiles), and to try and change `[/etc/portage/make.conf]` as little as possible. -I generally believe this is a significantly better system than stuffing everything into `[make.conf]`, and it isn't pushed that hard on Gentoo. +There is a big emphasis on writing your use flags in a separate [`/etc/portage/package.use`] file (or make it a folder and add use flags in different subfiles), and to try and change [`/etc/portage/make.conf`] as little as possible. +I generally believe this is a significantly better system than stuffing everything into [`make.conf`], and it isn't pushed that hard on Gentoo. That said, Gentoo still supports it, so I'm not missing out, but I probably wouldn't have used it. diff --git a/src/blog/how-to-encrypt-email/index.du b/src/blog/how-to-encrypt-email/index.du index 5518d55..ec9d546 100644 --- a/src/blog/how-to-encrypt-email/index.du +++ b/src/blog/how-to-encrypt-email/index.du @@ -42,29 +42,29 @@ By far, the easiest way to do this is via the website [url https://pgptool.org/ As an alternative, you can use a desktop program. The most popular one is [url https://www.gnupg.org/ GNU Privacy Guard] (GPG for short). It is [url https://gnupg.org/download/#binary available] on most desktop operating systems, including [url https://gpg4win.org/download.html Windows] and [url https://gpgtools.org/ MacOS]. -The *[Windows]* version comes with a graphical user interface, so it's easiest to use that: +The [*Windows*] version comes with a graphical user interface, so it's easiest to use that: :ordered 1. Open the application "Kleopatra" -2. Click on `[File]` -> `[New Certificate]` +2. Click on [`File`] -> [`New Certificate`] -3. Input your details and press `[OK]` +3. Input your details and press [`OK`] .bulleted - - Feel free to click on `[Advanced Settings]` and look if if the value for `[RSA]` is `[4096 bit]`, the value for `[+ RSA]` is enabled and is `[4096 bits]`, and finally both `[Signing]` and `[Authentication]` are selected + - Feel free to click on [`Advanced Settings`] and look if if the value for [`RSA`] is [`4096 bit`], the value for [`+ RSA`] is enabled and is [`4096 bits`], and finally both [`Signing`] and [`Authentication`] are selected -4. On the next screen, press `[Create]` +4. On the next screen, press [`Create`] 5. You'll be asked for a password. Make one up, and enter it, but do not forget it! .bulleted - - The password is used for your private key. If anyone gets ahold if it, they =[will]= be able to impersonate you. A password makes sure that doesn't happen, at least until you tell everyone that your key was leaked. + - The password is used for your private key. If anyone gets ahold if it, they [=will=] be able to impersonate you. A password makes sure that doesn't happen, at least until you tell everyone that your key was leaked. -6. On the final screen, click `[Finish]` +6. On the final screen, click [`Finish`] -7. To help with the next chapter, we'll extract your public key. In "Kleopatra" you should see a line, containing your name and email. Right-click on it, and select `[Export Certificate]`. +7. To help with the next chapter, we'll extract your public key. In "Kleopatra" you should see a line, containing your name and email. Right-click on it, and select [`Export Certificate`]. -On *[Linux]* and *[MacOS]*, you can use the command line: +On [*Linux*] and [*MacOS*], you can use the command line: :ordered 1. Enter this command in your favorite terminal @@ -90,7 +90,7 @@ Currently, the only one that provides free certificates is [url https://www.acta You should now have a text file with your public key in it. When you want to send an encrypted email to someone, ask them for their public key, and meanwhile send them your public key. It doesn't matter how you do that, even if it's with unencrypted emails. -Remember, =[never]= send your =[private]= key to anyone! +Remember, [=never=] send your [=private=] key to anyone! ## Configuring clients @@ -98,13 +98,13 @@ Now we need to configure your email application to automatically encrypt and dec When writing a message, don't forget to check if encryption is turned on for this email! On most clients, in the compose window, you'll have to select an option to enable encryption, but others do that automatically. -*[Freemium means it has a free and a paid tier. Premium means you have to pay for it. FOSS means it's free and open source. FreemiumOSS means it is free and open source, but also has paid tiers.]* +[*Freemium means it has a free and a paid tier. Premium means you have to pay for it. FOSS means it's free and open source. FreemiumOSS means it is free and open source, but also has paid tiers.*] :table_6 -'define 1 ^[[url #1 1]]^ -'define 2 ^[[url #2 2]]^ -'define 3 ^[[url #3 3]]^ -'define * ^[[url #* *]]^ +'define 1 [^[url #1 1]^] +'define 2 [^[url #2 2]^] +'define 3 [^[url #3 3]^] +'define * [^[url #* *]^] |= Client |= Type @@ -282,7 +282,7 @@ When writing a message, don't forget to check if encryption is turned on for thi |: [url https://github.com/M66B/FairEmail/blob/master/FAQ.md Yes][$*] -^[1]^ Available with an extension/plugin\n -^[2]^ Available in a paid version of the software (assuming the software is Freemium; this is true for all Premium software)\n -^[3]^ Available with a Premium account (even if the software is Free)\n -^[*]^ You can read S/MIME messages, but signing and encrypting is a pro feature +[^1^] Available with an extension/plugin\n +[^2^] Available in a paid version of the software (assuming the software is Freemium; this is true for all Premium software)\n +[^3^] Available with a Premium account (even if the software is Free)\n +[^*^] You can read S/MIME messages, but signing and encrypting is a pro feature diff --git a/src/blog/how-to-use-jira/bug.du b/src/blog/how-to-use-jira/bug.du index fcd51e3..d776367 100644 --- a/src/blog/how-to-use-jira/bug.du +++ b/src/blog/how-to-use-jira/bug.du @@ -10,12 +10,12 @@ 'define next_link ./releases.html Releases [$pagination_middle] -The Bug Tracking template is completely different from the [url ./scrum.html Scrum] and [url ./kanban.html Kanban] templates, because it =[offers only issue tracking]=. +The Bug Tracking template is completely different from the [url ./scrum.html Scrum] and [url ./kanban.html Kanban] templates, because it [=offers only issue tracking=]. -=[There are no boards, no cards, no backlog]=. All issues are accessed from the `[Issues]` page from the sidebar. +[=There are no boards, no cards, no backlog=]. All issues are accessed from the [`Issues`] page from the sidebar. [image ./img/issues-sidebar.png] -That's why this template is =[available only when creating a project]=. +That's why this template is [=available only when creating a project=]. -Of course, =[you can add boards at any time]=, but this project template doesn't add any by itself. +Of course, [=you can add boards at any time=], but this project template doesn't add any by itself. diff --git a/src/blog/how-to-use-jira/cards.du b/src/blog/how-to-use-jira/cards.du index 03d0ed4..8a5f1b7 100644 --- a/src/blog/how-to-use-jira/cards.du +++ b/src/blog/how-to-use-jira/cards.du @@ -22,7 +22,7 @@ 3. [url #issue-flagging Issue flagging] 4. [url #basic-issue-information Basic issue information] -=[Each issue is represented as an object with properties]=. More specifically, these objects are called 'cards'. +[=Each issue is represented as an object with properties=]. More specifically, these objects are called 'cards'. [image ./img/kanban-cards.png] @@ -33,11 +33,11 @@ Each card has the following properties: [image ./img/fields-cards.png] :unordered -- =[Project]= - the [url ./projects.html project] this card is stored in +- [=Project=] - the [url ./projects.html project] this card is stored in [image ./img/project-create-card.png] -- =[Issue type]= - the basic purpose of an issue (Improvement, Bug, ...) +- [=Issue type=] - the basic purpose of an issue (Improvement, Bug, ...) [image ./img/issue-types.png] @@ -53,109 +53,109 @@ Each card has the following properties: - [image ./img/sub-task-type.png Sub-task] - an issue that is directly connected to another issue. This is used for when a given issue needs to be broken down into separate even smaller issues. -- =[Summary]= - a (required) brief explanation of the issue +- [=Summary=] - a (required) brief explanation of the issue [image ./img/summary-create-card.png] -- =[Description]= - detailed explanation of the issue +- [=Description=] - detailed explanation of the issue [image ./img/description-create-card.png] -- =[Reporter]= - person who created the issue +- [=Reporter=] - person who created the issue [image ./img/reporter-create-card.png] -- =[Assignee]= - person who will work on the issue +- [=Assignee=] - person who will work on the issue [image ./img/assignee-create-card.png] -- =[Labels]= - tags with which you can organise even more the issue +- [=Labels=] - tags with which you can organise even more the issue [image ./img/label-create-card.png] -- =[Epic link]= - link of issue with type Epic +- [=Epic link=] - link of issue with type Epic [image ./img/epic-link-create-card.png] ## Creating -To create a card yourself, you need to =[press the `[Create]` button on the top bar]=. +To create a card yourself, you need to [=press the [`Create`] button on the top bar=]. [image ./img/create-header.png] ## Viewing -=[All]= cards (issues) can be viewed from a [url ./projects.html project]'s side menu, under 'Issues'. +[=All=] cards (issues) can be viewed from a [url ./projects.html project]'s side menu, under 'Issues'. [image ./img/issues-sidebar.png] -Of course, they can also be viewed through =[[url ./filters.html filters]]= and a =[[url ./projects.html project]'s board]=. +Of course, they can also be viewed through [=[url ./filters.html filters]=] and a [=[url ./projects.html project]'s board=]. ## How to use -By default, opening a card presents, at the top, it's =[key]= (think of it as an ID), +By default, opening a card presents, at the top, it's [=key=] (think of it as an ID), [image ./img/card-key.png] -it's =[summary]= below it, +it's [=summary=] below it, [image ./img/card-summary.png] -options for adding =[attachments]=, =[subtasks]=, =[linking issues]= and =[adding more apps]= (think of apps like extensions), +options for adding [=attachments=], [=subtasks=], [=linking issues=] and [=adding more apps=] (think of apps like extensions), [image ./img/card-attach-subtask.png] -following are the =[description]=, =[actual attachments]=, =[subtasks]=, =[linked issues]=, etc., +following are the [=description=], [=actual attachments=], [=subtasks=], [=linked issues=], etc., [image ./img/desc-att-sub-link.png] -and at the bottom you have the =[activity]=, consisting of =[comments]= on the issue, +and at the bottom you have the [=activity=], consisting of [=comments=] on the issue, [image ./img/activity-comments.png] -=[history]= of things that have happened to that issue, +[=history=] of things that have happened to that issue, [image ./img/activity-history.png] -and =[work logs]= (a bit later we talk about them in more detail). +and [=work logs=] (a bit later we talk about them in more detail). [image ./img/activity-work-log.png] ### Right side -To the right side, you have all of the different =[properties]= (some fields without a value will be hidden). +To the right side, you have all of the different [=properties=] (some fields without a value will be hidden). [image ./img/card-right-side.png] -On the top right you can change =[watch options]= ([url https://www.idalko.com/jira-watch-issues/ watching an issue] means you get notified by all changes done to it), you can =[share]= the card and do =[actions]= (the three dots). +On the top right you can change [=watch options=] ([url https://www.idalko.com/jira-watch-issues/ watching an issue] means you get notified by all changes done to it), you can [=share=] the card and do [=actions=] (the three dots). [image ./img/card-top-right.png] -=[Actions]= are things you can do to the whole card, like moving or deleting it. +[=Actions=] are things you can do to the whole card, like moving or deleting it. [image ./img/card-actions.png] -The most notable options are `[[url https://confluence.atlassian.com/jirasoftwarecloud/logging-work-on-issues-902499028.html Log work]]` and `[Add flag]`. +The most notable options are [`[url https://confluence.atlassian.com/jirasoftwarecloud/logging-work-on-issues-902499028.html Log work]`] and [`Add flag`]. ### Work log -In Jira, you can =[estimate how long an issue will take for it to be resolved]=. This is done through =[logging work]=. +In Jira, you can [=estimate how long an issue will take for it to be resolved=]. This is done through [=logging work=]. -In the `[Log work]` screen, you'll be met with a `[Time spent]` and `[Time remaining]` fields, that you'll need to fill with the appropriate information. +In the [`Log work`] screen, you'll be met with a [`Time spent`] and [`Time remaining`] fields, that you'll need to fill with the appropriate information. [image ./img/time-tracking.png] -The time remaining takes a =[default]= value from the =[previous time log]=, so you don't need to specify it every time. +The time remaining takes a [=default=] value from the [=previous time log=], so you don't need to specify it every time. ### Issue flagging -A =[flagged issue]= is an issue that is very important. Flagged issues are displayed in yellow to signify their needed attention. +A [=flagged issue=] is an issue that is very important. Flagged issues are displayed in yellow to signify their needed attention. [image ./img/flagged-card.png] ### Basic issue information -On the bottom right you can see =[when the issue was created]= and =[when it was last updated]=. You can also access the field configuration menu from the `[Configure]` button. It won't be covered in this tutorial, you can read about it [url https://confluence.atlassian.com/adminjiracloud/changing-a-field-configuration-844500798.html here]. +On the bottom right you can see [=when the issue was created=] and [=when it was last updated=]. You can also access the field configuration menu from the [`Configure`] button. It won't be covered in this tutorial, you can read about it [url https://confluence.atlassian.com/adminjiracloud/changing-a-field-configuration-844500798.html here]. [image ./img/time-and-configure.png] diff --git a/src/blog/how-to-use-jira/components.du b/src/blog/how-to-use-jira/components.du index c696e62..5f22167 100644 --- a/src/blog/how-to-use-jira/components.du +++ b/src/blog/how-to-use-jira/components.du @@ -15,15 +15,15 @@ 1. [url #creating-and-editing Creating and editing] 2. [url #adding-issues Adding issues] -Components are =[yet another way to group issues together]=. They don't have any specific meaning like versions, their usage depends on the project's organisation. +Components are [=yet another way to group issues together=]. They don't have any specific meaning like versions, their usage depends on the project's organisation. ## Creating and editing -Creating and editing them is done from the =[`[Components]` menu in the sidebar]=. +Creating and editing them is done from the [=[`Components`] menu in the sidebar=]. [image ./img/components-sidebar.png] -Creating one is done through the button on the top right (in the center if you don't have any components) by the name of `[Create component]`. +Creating one is done through the button on the top right (in the center if you don't have any components) by the name of [`Create component`]. [image ./img/create-component-empty.png] @@ -33,17 +33,17 @@ Clicking on it presents you with a screen where you input it's information. [image ./img/create-component-page.png] -=[A name is the only requirement]=. You can also add a =[description]=, =[a lead(er) for the component]= and =[person who gets assigned to an issue by default]=. +[=A name is the only requirement=]. You can also add a [=description=], [=a lead(er) for the component=] and [=person who gets assigned to an issue by default=]. ## Adding issues -Adding an issue to a component can be done either =[when creating it]= or =[when viewing it]=. +Adding an issue to a component can be done either [=when creating it=] or [=when viewing it=]. -=[Right under the summary]=, there is a place for indicating a component, named `[Components]`. +[=Right under the summary=], there is a place for indicating a component, named [`Components`]. [image ./img/components-create-card.png] -When viewing an issue, you can add one from the `[Components]` field to the right (you might need to first click on `[Show more fields]`). +When viewing an issue, you can add one from the [`Components`] field to the right (you might need to first click on [`Show more fields`]). [image ./img/show-fields.png] diff --git a/src/blog/how-to-use-jira/dashboards.du b/src/blog/how-to-use-jira/dashboards.du index ab46ac0..ddac024 100644 --- a/src/blog/how-to-use-jira/dashboards.du +++ b/src/blog/how-to-use-jira/dashboards.du @@ -14,52 +14,52 @@ 1. [url #adding-a-dashboard Adding a dashboard] 2. [url #adding-gadgets Adding gadgets] -Dashboards are a =[place where you can view a lot of information]=. +Dashboards are a [=place where you can view a lot of information=]. [image ./img/default-dashboard.png] -Dashboards are composed of =[gadgets]=. +Dashboards are composed of [=gadgets=]. [image ./img/gadgets.png] -Gadgets have functionality for =[displaying certain information]=, like `[Average Age Chart]` or `[Issues in progress]`. Each gadget can be setup to =[take information from one or more projects and/or saved filters]=. +Gadgets have functionality for [=displaying certain information=], like [`Average Age Chart`] or [`Issues in progress`]. Each gadget can be setup to [=take information from one or more projects and/or saved filters=]. ## Adding a dashboard -Dashboard can be added from the top bar, under `[Create dashboard]` in the `[Dashboards]` menu +Dashboard can be added from the top bar, under [`Create dashboard`] in the [`Dashboards`] menu [image ./img/create-dashboard-top.png] -or, if you are already in a dashboard, from `[Create dashboard]` in the three dots menu. +or, if you are already in a dashboard, from [`Create dashboard`] in the three dots menu. [image ./img/create-dashboard-dots.png] ## Adding gadgets -=[Note]=: you cannot add gadgets to the default dashboard. +[=Note=]: you cannot add gadgets to the default dashboard. -You can add gadgets either =[through the `[Add gadget]` button in the top right]= +You can add gadgets either [=through the [`Add gadget`] button in the top right=] [image ./img/add-gadget-top.png] -or, =[if you don't have any gadets]=, =[from the `[add a new gadget]` message(s)]=. +or, [=if you don't have any gadets=], [=from the [`add a new gadget`] message(s)=]. [image ./img/add-a-gadget.png] -After that, you are greeted by a window that =[shows all of the avalable ones]= (you might need to =[press `[Load all gadgets]`]=). +After that, you are greeted by a window that [=shows all of the avalable ones=] (you might need to [=press [`Load all gadgets`]=]). [image ./img/load-all.png] [image ./img/add-gadget.png] -Adding a gadget is as simple as clicking the button `[Add gadget]` next to the name of the gadget you want to add. +Adding a gadget is as simple as clicking the button [`Add gadget`] next to the name of the gadget you want to add. [image ./img/introduction-add.png] -After it is added, you'll =[need to configure it]=, usually a gadget =[requires atleast a filter/project]=. +After it is added, you'll [=need to configure it=], usually a gadget [=requires atleast a filter/project=]. [image ./img/bubble.png] -Options for different gadgets can be found on =[their top right corner, in the three dots menu]=. +Options for different gadgets can be found on [=their top right corner, in the three dots menu=]. [image ./img/bubble-dots.png] diff --git a/src/blog/how-to-use-jira/filters.du b/src/blog/how-to-use-jira/filters.du index 0ec6a9d..f66b78c 100644 --- a/src/blog/how-to-use-jira/filters.du +++ b/src/blog/how-to-use-jira/filters.du @@ -14,31 +14,31 @@ 1. [url #criteria Criteria] 2. [url #jql JQL] -=[Filters work like an advanced issue search that you can save]=. With filters you filter issues from chosen project(s) by their properties (status, type, start date, etc.). +[=Filters work like an advanced issue search that you can save=]. With filters you filter issues from chosen project(s) by their properties (status, type, start date, etc.). -Making filters is done through the `[Advanced issue search]` page, from the `[Filters]` menu. +Making filters is done through the [`Advanced issue search`] page, from the [`Filters`] menu. [image ./img/filters-advanced-issue-search.png] ## Criteria -From here you can see some criteria: `[Project]`, `[Type]`, `[Status]`, `[Assignee]`. +From here you can see some criteria: [`Project`], [`Type`], [`Status`], [`Assignee`]. [image ./img/criteria-advanced-issue-search.png] -Clicking on the criteria will reveal what options you can choose for it. Access to more criteria can be obtained via the `[+ More]` menu. +Clicking on the criteria will reveal what options you can choose for it. Access to more criteria can be obtained via the [`+ More`] menu. [image ./img/plus-more-advanced-issue-search.png] -After configuring your desired options, you can =[save the filter]= and use it later. To do so, simply click on `[Save as]` and enter a name for it. +After configuring your desired options, you can [=save the filter=] and use it later. To do so, simply click on [`Save as`] and enter a name for it. [image ./img/save-as-advanced-issue-search.png] [image ./img/save-filter-filters-advanced-issue-search.png] -You can view all of your filters from the conveniently named `[View all filters]` option in the `[Filters]` menu. +You can view all of your filters from the conveniently named [`View all filters`] option in the [`Filters`] menu. [image ./img/view-all-filters-advanced-issue-search.png] ## JQL -You can do =[more advanced search]= through `[JQL]` (Jira Query Language), but we won't be covering this topic. I can recommend [url https://www.atlassian.com/blog/jira-software/jql-the-most-flexible-way-to-search-jira-14 this article] on the subject. +You can do [=more advanced search=] through [`JQL`] (Jira Query Language), but we won't be covering this topic. I can recommend [url https://www.atlassian.com/blog/jira-software/jql-the-most-flexible-way-to-search-jira-14 this article] on the subject. diff --git a/src/blog/how-to-use-jira/index.du b/src/blog/how-to-use-jira/index.du index a1b3b0f..9ea578d 100644 --- a/src/blog/how-to-use-jira/index.du +++ b/src/blog/how-to-use-jira/index.du @@ -72,4 +72,4 @@ It has a lot of features that can be quite overwhelming for new comers, especially these who are new to project management software. That's why I'm writing this tutorial. -=[Note]=: certain actions can be done only from a project administrator +[=Note=]: certain actions can be done only from a project administrator diff --git a/src/blog/how-to-use-jira/kanban.du b/src/blog/how-to-use-jira/kanban.du index 5e5eb00..0a6e707 100644 --- a/src/blog/how-to-use-jira/kanban.du +++ b/src/blog/how-to-use-jira/kanban.du @@ -15,7 +15,7 @@ 1. [url #create-board Create board] 2. [url #backlog Backlog] -Kanban is a =[way for visually organising work items]= (issues in our case). Kanban consists of =[columns]= and =[cards]=, where cards are the work items and are =[moved from one column to another]= depending on the situation. This should sound =[familiar]=, because that is how [url ./projects.md Boards] work. +Kanban is a [=way for visually organising work items=] (issues in our case). Kanban consists of [=columns=] and [=cards=], where cards are the work items and are [=moved from one column to another=] depending on the situation. This should sound [=familiar=], because that is how [url ./projects.md Boards] work. In a projects that uses the kanban template, boards can access directly all of the available issues. @@ -23,16 +23,16 @@ This tutorial focuses on the basics, but you can find a lot of information in [u ## Create board -This template can be chosen when =[creating a project]= +This template can be chosen when [=creating a project=] [image ./img/choose-classic-template.png] -and =[from the `[Create board]` screen]=. +and [=from the [`Create board`] screen=]. [image ./img/scrum-kanban-board.png] ## Backlog -In kanban, =[the backlog is just another column in your board(s)]=. It can be removed entirely. +In kanban, [=the backlog is just another column in your board(s)=]. It can be removed entirely. [image ./img/backlog-kanban.png] diff --git a/src/blog/how-to-use-jira/pages.du b/src/blog/how-to-use-jira/pages.du index b2e0466..5340091 100644 --- a/src/blog/how-to-use-jira/pages.du +++ b/src/blog/how-to-use-jira/pages.du @@ -10,13 +10,13 @@ 'define next_link ./components.html Components [$pagination_middle] -=[Pages are a place for documents for your team]=. The goal is to have a centralised location where everyone in your team can share knowledge. +[=Pages are a place for documents for your team=]. The goal is to have a centralised location where everyone in your team can share knowledge. [image ./img/test-page.png] -Pages are powered by another Atlasian product, named `[Confluence]`. It is a =[subscription-based software]=, but it does also offer a free 30-day trial. +Pages are powered by another Atlasian product, named [`Confluence`]. It is a [=subscription-based software=], but it does also offer a free 30-day trial. -=[All documents]= (pages) that you write are =[organised into `[Spaces]`]=. When creating a page you can choose one of many templates or just start off with a blank one. +[=All documents=] (pages) that you write are [=organised into [`Spaces`]=]. When creating a page you can choose one of many templates or just start off with a blank one. -=[Confluence won't be covered in this tutorial]=. You can read more about it [url https://www.atlassian.com/software/confluence/guides/get-started/set-up here]. +[=Confluence won't be covered in this tutorial=]. You can read more about it [url https://www.atlassian.com/software/confluence/guides/get-started/set-up here]. diff --git a/src/blog/how-to-use-jira/projects.du b/src/blog/how-to-use-jira/projects.du index ecf5fe9..fd64c86 100644 --- a/src/blog/how-to-use-jira/projects.du +++ b/src/blog/how-to-use-jira/projects.du @@ -23,59 +23,59 @@ -In short, =[projects are a collection of issues]= with added functionality for =[organising them, getting statistics, etc]=. +In short, [=projects are a collection of issues=] with added functionality for [=organising them, getting statistics, etc=]. [image ./img/projects.png] ## Creating a project -To create a project, either =[click on `[Create project]` from the menu `[Projects]` in the top bar]=, +To create a project, either [=click on [`Create project`] from the menu [`Projects`] in the top bar=], [image ./img/create-project-top.png] -or =[click on the `[Create project]` button in the `[View all projects]` page]=. +or [=click on the [`Create project`] button in the [`View all projects`] page=]. [image ./img/view-all-projects-top.png] [image ./img/create-project.png] -=[Note]=: when you =[have created your account]= the first thing you'll see is the `[Create project]` page. +[=Note=]: when you [=have created your account=] the first thing you'll see is the [`Create project`] page. -You'll be met by the `[Choose project type]` screen. From here choose `[Classic project]`, in this tutorial the `[Next-gen project]` types =[won't be covered]=. +You'll be met by the [`Choose project type`] screen. From here choose [`Classic project`], in this tutorial the [`Next-gen project`] types [=won't be covered=]. [image ./img/choose-project-type.png] -After that you'll need to put a =[name]= for your project, set a =[key]= (used as an ID for issues ; it is automatically generated, but you can change it if you want) and select a =[template]=. +After that you'll need to put a [=name=] for your project, set a [=key=] (used as an ID for issues ; it is automatically generated, but you can change it if you want) and select a [=template=]. [image ./img/create-project-new.png] -This tutorial covers =[only]= the three classic software templates: =[[url ./kanban.html Kanban]]=, =[[url ./scrum.html Scrum]]= and =[[url ./bug.html Bug tracking]]=. +This tutorial covers [=only=] the three classic software templates: [=[url ./kanban.html Kanban]=], [=[url ./scrum.html Scrum]=] and [=[url ./bug.html Bug tracking]=]. [image ./img/choose-classic-template.png] -In a nutshell, =[templates]= govern how =[boards and issues should work together]=. Later in the tutorial we cover the differences between these templates. +In a nutshell, [=templates=] govern how [=boards and issues should work together=]. Later in the tutorial we cover the differences between these templates. Projects also have [url ./releases.html Releases], [url ./pages.html Pages] and [url ./components.html Components], that are also explored. ## Boards -Each project contains, amongst many other things, boards. =[Boards are a way to better organise results from [url ./filters.html filters]]=. By default every project gets a board with a filter for all of the project's issues. +Each project contains, amongst many other things, boards. [=Boards are a way to better organise results from [url ./filters.html filters]=]. By default every project gets a board with a filter for all of the project's issues. ### Columns -=[Boards are divided into columns]= that contain the cards (issues). A card can move =[freely]= from one column to another. +[=Boards are divided into columns=] that contain the cards (issues). A card can move [=freely=] from one column to another. [image ./img/SOD.png] -To illustrate how this could be useful, let's say we have three columns: `[TO DO]`, `[DOING]` and `[DONE]`. +To illustrate how this could be useful, let's say we have three columns: [`TO DO`], [`DOING`] and [`DONE`]. [image ./img/todo-doing-done.png] -When you create an issue you initially put it in the `[TO DO]` column. After someone has started working on it, they put the issue in the `[DOING]` column. Finally, when the issue is resolved, it is put in the `[DONE]` column. +When you create an issue you initially put it in the [`TO DO`] column. After someone has started working on it, they put the issue in the [`DOING`] column. Finally, when the issue is resolved, it is put in the [`DONE`] column. -Of course, the name, quantity and purpose of different columns =[depend on the project's organisation]=. +Of course, the name, quantity and purpose of different columns [=depend on the project's organisation=]. -Adding and removing columns can be done from the `[Columns]` tab in the `[Board settings]` menu (three dots on the top right of a board). +Adding and removing columns can be done from the [`Columns`] tab in the [`Board settings`] menu (three dots on the top right of a board). [image ./img/board-settings.png] @@ -83,17 +83,17 @@ Adding and removing columns can be done from the `[Columns]` tab in the `[Board ### Adding more boards to a project -You can also add to a project as many =[[url ./scrum.html Scrum]]= and =[[url ./kanban.html Kanban]]= templated boards as you want. +You can also add to a project as many [=[url ./scrum.html Scrum]=] and [=[url ./kanban.html Kanban]=] templated boards as you want. -This can be done, either while in a board, from =[clicking the three dots and choosing `[Create board]`]= +This can be done, either while in a board, from [=clicking the three dots and choosing [`Create board`]=] [image ./img/create-board.png] -or =[in the sidebar, from the `[Board]` menu]=. +or [=in the sidebar, from the [`Board`] menu=]. [image ./img/sidebar-create-board.png] -After that, you are met with the `[Create a board]` window, where you can choose your template. +After that, you are met with the [`Create a board`] window, where you can choose your template. [image ./img/scrum-kanban-board.png] @@ -102,42 +102,42 @@ Once you've made your choice, you will be met with three options: [image ./img/board-from.png] :unordered -- =[Board created with new Software project]= - creates a new project with a new board (has the name of the project). +- [=Board created with new Software project=] - creates a new project with a new board (has the name of the project). [image ./img/npb.png] -- =[Board from existing project]= - creates a board that gets the filter from another project +- [=Board from existing project=] - creates a board that gets the filter from another project [image ./img/ntb.png] -- =[Board from an existing Saved Filter]= - as it says, you add to the project (indicated in the `[Location]` field) a board based on a saved filter +- [=Board from an existing Saved Filter=] - as it says, you add to the project (indicated in the [`Location`] field) a board based on a saved filter [image ./img/ntb-filter.png] ## Backlog -=[The backlog is a place for issues that outline a general task/feature]=. +[=The backlog is a place for issues that outline a general task/feature=]. -Depending on your project template, the backlog will either be a =[separate window ([url ./scrum.html Scrum])]=, +Depending on your project template, the backlog will either be a [=separate window ([url ./scrum.html Scrum])=], [image ./img/scrum-backlog.png] -=[just a column in a board ([url ./kanban.html Kanban])]=, +[=just a column in a board ([url ./kanban.html Kanban])=], [image ./img/backlog-kanban.png] -or =[nonexistent ([url ./bug.md bug tracking])]=. +or [=nonexistent ([url ./bug.md bug tracking])=]. The purpose of the backlog depends on the template and it is described in the page of each template. ## Add item -=[You can also add some resources to the sidebar of your project]= for everyone to use. That is done through the `[Add Item]` menu. +[=You can also add some resources to the sidebar of your project=] for everyone to use. That is done through the [`Add Item`] menu. [image ./img/add-item-kanban.png] -From here you can =[add a website shortcut]=, simply by putting the web address and giving it a name. +From here you can [=add a website shortcut=], simply by putting the web address and giving it a name. [image ./img/add-item-to-project.png] @@ -147,12 +147,12 @@ The name is used for showing the shortcut on the sidebar. [image ./img/added-site.png] -You can also add a `[Bitbucket]` or `[GitHub]` repository which you can =[leave]= only as a =[shortcut]=, or you can =[integrate]= it so that =[issues are transferred to Jira]=. +You can also add a [`Bitbucket`] or [`GitHub`] repository which you can [=leave=] only as a [=shortcut=], or you can [=integrate=] it so that [=issues are transferred to Jira=]. [image ./img/test-repo.png] [image ./img/test-repo-sidebar.png] -=[Integration won't be covered in this tutorial]=, but I can recommend [url https://www.idalko.com/jira-github-integration/ this] article for `[GitHub]` integration and [url https://www.idalko.com/jira-bitbucket-integration/ this] one for `[Bitbucket]` integration. +[=Integration won't be covered in this tutorial=], but I can recommend [url https://www.idalko.com/jira-github-integration/ this] article for [`GitHub`] integration and [url https://www.idalko.com/jira-bitbucket-integration/ this] one for [`Bitbucket`] integration. -From the `[Add Item]` menu you can also =[toggle the shortcut to [url ./pages.html Pages]]=. +From the [`Add Item`] menu you can also [=toggle the shortcut to [url ./pages.html Pages]=]. diff --git a/src/blog/how-to-use-jira/releases.du b/src/blog/how-to-use-jira/releases.du index 430de92..1642c61 100644 --- a/src/blog/how-to-use-jira/releases.du +++ b/src/blog/how-to-use-jira/releases.du @@ -10,12 +10,12 @@ 'define next_link ./pages.html Pages [$pagination_middle] -The `[Releases]` page in a project shows =[versions]=, the ones in development and the ones that are completed. +The [`Releases`] page in a project shows [=versions=], the ones in development and the ones that are completed. -=[Versions are just a big collection of issues]= and the =[goal of a released version]= is for =[all of it's issues to be resolved]=. It serves as a point in time for the development of a project. +[=Versions are just a big collection of issues=] and the [=goal of a released version=] is for [=all of it's issues to be resolved=]. It serves as a point in time for the development of a project. ## Adding issues to a version -When creating an issue, you can specify a version in the `[Fix versions]` property. +When creating an issue, you can specify a version in the [`Fix versions`] property. [image ./img/fix-versions.png] diff --git a/src/blog/how-to-use-jira/scrum.du b/src/blog/how-to-use-jira/scrum.du index 37ca494..dffe4ec 100644 --- a/src/blog/how-to-use-jira/scrum.du +++ b/src/blog/how-to-use-jira/scrum.du @@ -16,40 +16,40 @@ 2. [url #boards-and-issues Boards and Issues] 3. [url #create-board Create board] -The scrum template is very similar to the kanban template, with one big difference: =[sprints]=. +The scrum template is very similar to the kanban template, with one big difference: [=sprints=]. -=[All issues]= are put into the =[backlog]= (which is now a =[separate page]=). From there, they are organised into =[sprints]=. +[=All issues=] are put into the [=backlog=] (which is now a [=separate page=]). From there, they are organised into [=sprints=]. -In general [url https://www.atlassian.com/agile agile software development], a =[sprint is a small duration of time]= (one to four weeks) where the team focuses on a =[set of tasks]= and at the end everyone =[evaluates the results]= and plans the next sprint. +In general [url https://www.atlassian.com/agile agile software development], a [=sprint is a small duration of time=] (one to four weeks) where the team focuses on a [=set of tasks=] and at the end everyone [=evaluates the results=] and plans the next sprint. -Your =[boards only work on the issues of the currently active sprint]=. +Your [=boards only work on the issues of the currently active sprint=]. ## Backlog -As we've discussed, the =[backlog]= is used for organising =[all issues]= into =[sprints]=. +As we've discussed, the [=backlog=] is used for organising [=all issues=] into [=sprints=]. [image ./img/sample-scrum-backlog.png] -From here you can also organise =[Versions]= (refer to [url ./releases.html Releases]) and =[Epics]= (refer to [url ./cards.html Cards]). An important note is that Epics in this context don't need to have their linked issues in only one sprint. +From here you can also organise [=Versions=] (refer to [url ./releases.html Releases]) and [=Epics=] (refer to [url ./cards.html Cards]). An important note is that Epics in this context don't need to have their linked issues in only one sprint. [image ./img/versions-and-epics.png] -Creating a sprint is done from the conveniently named `[Create sprint]` button. It shows a box on top where you can either move issues from the backlog to the sprint or create entirely new issues. +Creating a sprint is done from the conveniently named [`Create sprint`] button. It shows a box on top where you can either move issues from the backlog to the sprint or create entirely new issues. [image ./img/sample-sprint.png] ## Boards and Issues -As previously mentioned, boards have access only to the issues in the active sprint. This is also reflected in the user interface. After selecting a board from the sidebar, you view it from the `[Active sprints]` page. +As previously mentioned, boards have access only to the issues in the active sprint. This is also reflected in the user interface. After selecting a board from the sidebar, you view it from the [`Active sprints`] page. [image ./img/active-sprints.png] ## Create board -This template can be chosen when =[creating a project]= +This template can be chosen when [=creating a project=] [image ./img/choose-classic-template.png] -and =[from the `[Create board]` screen]=. +and [=from the [`Create board`] screen=]. [image ./img/scrum-kanban-board.png] diff --git a/src/blog/icon-fonts-arent-evil-you-just-have-to-care/index.du b/src/blog/icon-fonts-arent-evil-you-just-have-to-care/index.du index d09c890..35e9fcf 100644 --- a/src/blog/icon-fonts-arent-evil-you-just-have-to-care/index.du +++ b/src/blog/icon-fonts-arent-evil-you-just-have-to-care/index.du @@ -26,16 +26,16 @@ First, we have to get acquaintanced with why I wanted change: before the big rew For [url https://gitlab.com/Syndamia/syndamiadotcom/-/releases/v3.0 quite a while] I've added support for an alternative light theme, but ever since the beginning icons have been an issue. How can you change the color, or more specifically, the internal styling of an SVG? -You have a [url https://stackoverflow.com/questions/22252472/how-can-i-change-the-color-of-an-svg-element couple of options], if you include it with a normal `[]` tag, as I was doing, you could do some [url https://stackoverflow.com/a/53336754 magic with filters] to change the exact color, though this is kinda difficult and [url https://caniuse.com/css-filters browsers support filters since somewhat recently]. +You have a [url https://stackoverflow.com/questions/22252472/how-can-i-change-the-color-of-an-svg-element couple of options], if you include it with a normal [``] tag, as I was doing, you could do some [url https://stackoverflow.com/a/53336754 magic with filters] to change the exact color, though this is kinda difficult and [url https://caniuse.com/css-filters browsers support filters since somewhat recently]. This is a deal-breaker, because I care about older browsers and without that CSS property, icons become very difficult to see on the light theme. -Another option is to load it with an `[\]`, `[\]` or `[\ @@ -188,7 +188,7 @@ - В началото на часа давам задачи, вие ги решавате. - Всички текстови редактори/IDE-та са позволени. - До края на часа трябва да предадете написаното от вас в [url ./github_classroom.html#-github-classroom-1 GitHub Classroom] -- Ще връщам обратна връзка към предаденото, *[моля да я четете!]* +- Ще връщам обратна връзка към предаденото, [*моля да я четете!*] :slide @@ -203,7 +203,7 @@ ; За самоподготовка : По-сложни задачи, които ще описват възможни проблеми от реалния свят ; За любознателните -: 1-2 сложни задачи, чиято цел е да се реализира *[реалистичен]* използваем софтуерен компонент +: 1-2 сложни задачи, чиято цел е да се реализира [*реалистичен*] използваем софтуерен компонент :middle_slide35 @@ -223,7 +223,7 @@ .unordered - Ще чуете и други мнения от екипа по тематa - Анализ на генериран изход от ИИ ще бъде разглеждан в курса -- На практикумите ви е позволено да го ползвате, =[но]= не го окуражавам +- На практикумите ви е позволено да го ползвате, [=но=] не го окуражавам :slide35 @@ -232,9 +232,9 @@ .p Различни умения са: .numbered -1. да =[напишеш сам]= код от нулата -2. да =[четеш]= код и разбереш какво прави -3. да =[модифицираш/допълниш]= вече написан код +1. да [=напишеш сам=] код от нулата +2. да [=четеш=] код и разбереш какво прави +3. да [=модифицираш/допълниш=] вече написан код .unordered - Чрез ИИ избягвате да правите първото. diff --git a/src/teaching/upp-2025/week01/visual_studio.du b/src/teaching/upp-2025/week01/visual_studio.du index a6735fb..cf7a9d4 100644 --- a/src/teaching/upp-2025/week01/visual_studio.du +++ b/src/teaching/upp-2025/week01/visual_studio.du @@ -19,14 +19,14 @@ [$br2] .p -=[Кодът е чисто и просто текст]=, компилаторът е специалната програма, която превръща този текст в нещо, което може компютъра да изпълни. +[=Кодът е чисто и просто текст=], компилаторът е специалната програма, която превръща този текст в нещо, което може компютъра да изпълни. .p -За писане и редактиране на текст ползваме =[текстови редактори]=. +За писане и редактиране на текст ползваме [=текстови редактори=]. Програмистите са искали да улеснят работата си, затова модерните текстови редактори поддържат много помощни функционалности: показване на грешки на точния ред, автоматично форматиране, ... .p -За някои и това не е било достатъчно удобно, затова са създадени =[Integrated Development Environment]= (IDE), програми които съдържат в себе си всичко нужно за разработка на код. +За някои и това не е било достатъчно удобно, затова са създадени [=Integrated Development Environment=] (IDE), програми които съдържат в себе си всичко нужно за разработка на код. Тоест, те са текстови редактори, но "вградено" могат да компилират код, да менажират сегашното repository, ... @@ -179,7 +179,7 @@ Visual Studio е вече инсталирано там. В Solution Explorer имате всички файлове от проекта (Visual Studio позволява да групирате няколко проекта в едно, наречено Solution, не е нужно да се занимавате). .p -Тук =[единственото важно за вас се намира в папката "Source Files"]=. +Тук [=единственото важно за вас се намира в папката "Source Files"=]. В нея ще се намира вашия код, всичко останало са допълнителни неща, които са релевантни за по-големи проекти. diff --git a/src/teaching/upp-2025/week01/zip.du b/src/teaching/upp-2025/week01/zip.du index 57457a8..d81320a 100644 --- a/src/teaching/upp-2025/week01/zip.du +++ b/src/teaching/upp-2025/week01/zip.du @@ -26,7 +26,7 @@ [$br4] :unordered -- Под Windows 11 с *[новото]* меню което излиза при натискане на десен бутон, можете директно да архивирате селектираните файлове +- Под Windows 11 с [*новото*] меню което излиза при натискане на десен бутон, можете директно да архивирате селектираните файлове - Тоест, процедурата е .numbered 1. Селекция на файловете за архивиране @@ -60,11 +60,11 @@ .ordered 1. Селектирате файловете които искате да архивирате -2. Десен бутон *[(под Windows 11 трябва да натиснете "Show more options")]* +2. Десен бутон [*(под Windows 11 трябва да натиснете "Show more options")*] 3. Задържате курсора върху "7-Zip" -4. Избирате `[Add to "SOMETHING.=[zip]="]`, където `[SOMETHING]` ще е името на папката в която се намирате. +4. Избирате [`Add to "SOMETHING.[=zip=]"`], където [`SOMETHING`] ще е името на папката в която се намирате. Това директно създава архив с името на текущата папка. -5. Алтернативно избирате `[Add to archive...]`. +5. Алтернативно избирате [`Add to archive...`]. От там се отваря прозорец с настройки, най-важно под "Archive format" да изберете ZIP. Другите неща не е нужно да променяте. @@ -87,14 +87,14 @@ .p .font20 -*[Ползваш Linux и се нуждаеш от туториал? Слабо.]* +[*Ползваш Linux и се нуждаеш от туториал? Слабо.*] [$br5] ### Чрез командния ред .ordered -1. Инсталираш `[zip]` командата (пакета почти винаги също се казва `[zip]`) +1. Инсталираш [`zip`] командата (пакета почти винаги също се казва [`zip`]) 2. Извикваш команда във следната форма: ```bash zip archive.zip file1 file2 ... diff --git a/src/teaching/upp-2025/week02/index.du b/src/teaching/upp-2025/week02/index.du index b014ef9..d1be61f 100644 --- a/src/teaching/upp-2025/week02/index.du +++ b/src/teaching/upp-2025/week02/index.du @@ -20,66 +20,66 @@ GitHub Classroom: [url https://classroom.github.com/a/DRjtkc6f] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение02.csv Решение] -Покажете сумата на `[INPUT1]` и 8 в "popup". +Покажете сумата на [`INPUT1`] и 8 в "popup". ## Задача 3 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение03.csv Решение] -Покажете числото `[INPUT1]` в "popup", но с обърнат знак. +Покажете числото [`INPUT1`] в "popup", но с обърнат знак. ## Задача 4 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение04.csv Решение] -Покажете `[INPUT1]` умножено по две в "popup". +Покажете [`INPUT1`] умножено по две в "popup". ## Задача 5 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение05.csv Решение] -Ако `[INPUT1]` е равно на 10, покажете в "popup" стойността 1. +Ако [`INPUT1`] е равно на 10, покажете в "popup" стойността 1. Иначе, покажете стойността 0. ## Задача 6 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение06.csv Решение] -Покажете в "popup" числото 1 ако `[INPUT1]` =[или]= `[INPUT2]` е равно на 5. +Покажете в "popup" числото 1 ако [`INPUT1`] [=или=] [`INPUT2`] е равно на 5. Иначе покажете 0. ## Задача 7 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение07.csv Решение] -Покажете в "popup" числото 1 ако `[INPUT1]` =[и]= `[INPUT2]` са равни на 5. +Покажете в "popup" числото 1 ако [`INPUT1`] [=и=] [`INPUT2`] са равни на 5. Иначе покажете 0. ## Задача 8 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение08.csv Решение] -Покажете в "popup" умножението на `[INPUT1]` и `[INPUT2]`. -Допускаме, че `[INPUT2]` е неотрицателно цяло число. +Покажете в "popup" умножението на [`INPUT1`] и [`INPUT2`]. +Допускаме, че [`INPUT2`] е неотрицателно цяло число. ## Задача 9 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение09.csv Решение] -Нека `[INPUT1]` да обозначава разликата на аритметична прогресия (разликата между два съседни елементa) и `[INPUT2]` да обозначава индекса на елемент в тази прогресия. +Нека [`INPUT1`] да обозначава разликата на аритметична прогресия (разликата между два съседни елементa) и [`INPUT2`] да обозначава индекса на елемент в тази прогресия. -Покажаете в "popup" числото на `[INPUT2]` позиция от аритметичната прогресия. +Покажаете в "popup" числото на [`INPUT2`] позиция от аритметичната прогресия. Нека първия елемент винаги е 0 и неговия индекс е 1. -Допускаме, че `[INPUT2]` е неотрицателно цяло число. +Допускаме, че [`INPUT2`] е неотрицателно цяло число. ## Задача 10 .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week02/Решение10.csv Решение] .note -=[(11.09.2025)]= Вече в условието и `[INPUT1]` е неотрицателно, иначе решението става твърде голямо. +[=(11.09.2025)=] Вече в условието и [`INPUT1`] е неотрицателно, иначе решението става твърде голямо. -Покажете в "popup" делението на `[INPUT1]` и `[INPUT2]`, закръглено нагоре. -Допускаме, че `[INPUT1]` и `[INPUT2]` са неотрицателни цели числа. +Покажете в "popup" делението на [`INPUT1`] и [`INPUT2`], закръглено нагоре. +Допускаме, че [`INPUT1`] и [`INPUT2`] са неотрицателни цели числа. Може да зачитате, че резултата при деление на 0 е 0. diff --git a/src/teaching/upp-2025/week02/machine.du b/src/teaching/upp-2025/week02/machine.du index 089bf0a..6c63d22 100644 --- a/src/teaching/upp-2025/week02/machine.du +++ b/src/teaching/upp-2025/week02/machine.du @@ -8,7 +8,7 @@ В тази таблица може да редактирате клетките на колона A и тези срещу INPUT1 и INPUT2. При изпълнение, всяка клетка в A се обикаля отгоре-надолу (показано с жълто). -Ако срещне =[команда]= тогава потенциално прочита и долната клетка, и извършва някакво действие. +Ако срещне [=команда=] тогава потенциално прочита и долната клетка, и извършва някакво действие. Повече подробности в [url ./machine_manual.html упътването]. Списък от налични команди [url #section-1 в дъното на страницата]. @@ -19,25 +19,25 @@ ## Команди :defs -; `[ASUM]` -: Прави `[A = A + <числото в долната клетка>]` +; [`ASUM`] +: Прави [`A = A + <числото в долната клетка>`] -; `[ASUBTRACT]` -: Прави `[A = A - <числото в долната клетка>]` +; [`ASUBTRACT`] +: Прави [`A = A - <числото в долната клетка>`] -; `[ASHOW]` -: Показва стойността на `[A]` като pop-up. +; [`ASHOW`] +: Показва стойността на [`A`] като pop-up. -; `[BSUM]` -: Прави `[B = B + <числото в долната клетка>]` +; [`BSUM`] +: Прави [`B = B + <числото в долната клетка>`] -; `[BSUBTRACT]` -: Прави `[B = B - <числото в долната клетка>]` +; [`BSUBTRACT`] +: Прави [`B = B - <числото в долната клетка>`] -; `[GOTOBZ]` -: Ако `[B]` =[е]= 0, тогава отива на реда, посочен от следващата клетка. +; [`GOTOBZ`] +: Ако [`B`] [=е=] 0, тогава отива на реда, посочен от следващата клетка. Иначе продължава нататък. -; `[GOTOBN]` -: Ако `[B]` =[е по-голямо или равно на]= 0, тогава отива на реда, посочен от следващата клетка. +; [`GOTOBN`] +: Ако [`B`] [=е по-голямо или равно на=] 0, тогава отива на реда, посочен от следващата клетка. Иначе продължава нататък. diff --git a/src/teaching/upp-2025/week02/machine_manual.du b/src/teaching/upp-2025/week02/machine_manual.du index acf5559..7090a12 100644 --- a/src/teaching/upp-2025/week02/machine_manual.du +++ b/src/teaching/upp-2025/week02/machine_manual.du @@ -18,8 +18,8 @@ - Целта е да разиграем мисленето за програмиране - Без да пишем истински код - "Машинната таблица" е специална таблица, която създадох за този практикум\n - *[(щеше да е на Excel ама...)]* -- Тя симулира действието на един =[много]= прост компютър + [*(щеше да е на Excel ама...)*] +- Тя симулира действието на един [=много=] прост компютър :slide35 @@ -37,7 +37,7 @@ .centered .font18 -*[(По принцип ще спре при първия празен ред)]* +[*(По принцип ще спре при първия празен ред)*] .centered .p @@ -48,7 +48,7 @@ .centered .p -Продължава да обикаля клетки, докато не срещне =[празна клетка]= или не свършат всички клетки +Продължава да обикаля клетки, докато не срещне [=празна клетка=] или не свършат всички клетки .centered .p @@ -58,17 +58,17 @@ :middle_slide35 .unordered -- Във всяка една клетка може да срещне =[команда]= или =[число]= +- Във всяка една клетка може да срещне [=команда=] или [=число=] - Очаква последователност от команди в колона A -- След =[някои]= команди, може да се срещне и число +- След [=някои=] команди, може да се срещне и число - Стойности могат да се въвеждат в колоната A - Клетките "A" и "B" стават 0 при изпълнение -- Всяка команда работи със стойността на клетката "A" =[или]= "B" +- Всяка команда работи със стойността на клетката "A" [=или=] "B" :middle_slide35 -## Командата `[ASHOW]` +## Командата [`ASHOW`] .p Показва стойността на клетката A като popup @@ -79,7 +79,7 @@ :middle_slide35 -## Командата `[ASUM]` +## Командата [`ASUM`] .p Поглежда числото в долната клетка и го сумира към клетката "А". @@ -101,10 +101,10 @@ :middle_slide35 -## Командата `[ASUBTRACT]` +## Командата [`ASUBTRACT`] .p -Като `[ASUM]`, но изважда вместо да събере. +Като [`ASUM`], но изважда вместо да събере. .p [image ./img/table_asubtract.gif] @@ -143,29 +143,29 @@ :middle_slide35 -## Командата `[BSUM]` +## Командата [`BSUM`] .p -Същото като `[ASUM]`, но с клетка "B". +Същото като [`ASUM`], но с клетка "B". -## Командата `[BSUBTRACT]` +## Командата [`BSUBTRACT`] .p -Същото като `[ASUBTRACT]`, но с клетка "B". +Същото като [`ASUBTRACT`], но с клетка "B". [$br1] .p -=[Нямаме `[BSHOW]`!]= +[=Нямаме [`BSHOW`]!=] Но имаме други специални команди. :middle_slide35 -## Командата `[GOTOBZ]` +## Командата [`GOTOBZ`] .p -=[Ако]= клетка "B" е равна на 0, тогава прочита следващата клетка и отива на посочения ред. +[=Ако=] клетка "B" е равна на 0, тогава прочита следващата клетка и отива на посочения ред. .p [image ./img/table_gotobz.gif] @@ -174,7 +174,7 @@ :middle_slide .p -=[Иначе]= продължава напред +[=Иначе=] продължава напред .p [image ./img/table_gotobz_false.gif] @@ -182,17 +182,17 @@ :middle_slide35 -## Командата `[GOTOBN]` +## Командата [`GOTOBN`] .p -Същата като `[GOTOBZ]`, обаче отива на посочения ред когато "B" е =[по-голямо или равно]= на 0 (неотрицателно). +Същата като [`GOTOBZ`], обаче отива на посочения ред когато "B" е [=по-голямо или равно=] на 0 (неотрицателно). :middle_slide35 .unordered - Употребата на останалите бутони трябва да е явна. -- "Запази" запазва =[само]= колона A! +- "Запази" запазва [=само=] колона A! :middle_slide35 diff --git a/src/teaching/upp-2025/week03/index.du b/src/teaching/upp-2025/week03/index.du index c1001af..6eeb8f4 100644 --- a/src/teaching/upp-2025/week03/index.du +++ b/src/teaching/upp-2025/week03/index.du @@ -78,10 +78,10 @@ GitHub Classroom: [url https://classroom.github.com/a/UMc2WhVX] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week03/Exercise05.cpp Решение] -Получавате десетично число: сума в =[левове]=. -Трябва да върнете същата сума в =[евро]=, като `[1 € = 1.95583 лв]`. +Получавате десетично число: сума в [=левове=]. +Трябва да върнете същата сума в [=евро=], като [`1 € = 1.95583 лв`]. -*[Поради прецизност при такива числа, вашите изходи може с много малко да се различават.]* +[*Поради прецизност при такива числа, вашите изходи може с много малко да се различават.*] :table_2 |= Вход @@ -141,7 +141,7 @@ GitHub Classroom: [url https://classroom.github.com/a/UMc2WhVX] .bulleted - средно аритметично, - сума, -- сума от вида `[1/<първо число> + 1/<второ число> + ...]`, +- сума от вида [`1/<първо число> + 1/<второ число> + ...`], - умножение. :table_2 @@ -162,11 +162,11 @@ GitHub Classroom: [url https://classroom.github.com/a/UMc2WhVX] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week03/Exercise08.cpp Решение] -Получавате 5 реални числа: коефициентите на полином от трета степен `[a]` (`[a]` различно от 0), `[b]`, `[c]`, `[d]` и потенциален негов корен `[x]`. +Получавате 5 реални числа: коефициентите на полином от трета степен [`a`] ([`a`] различно от 0), [`b`], [`c`], [`d`] и потенциален негов корен [`x`]. -Трябва да върнете 1 ако `[x]` е корен на уравнението и 0 ако не е. +Трябва да върнете 1 ако [`x`] е корен на уравнението и 0 ако не е. -Припомняме, че `[x]` е корен на кубично уравнение, когато: +Припомняме, че [`x`] е корен на кубично уравнение, когато: [image ./img/cubic.png] @@ -271,14 +271,14 @@ GitHub Classroom: [url https://classroom.github.com/a/UMc2WhVX] От входа ще получите два ъгъла в радиани, α и β, чиято сума е между 0 и π/2 (включително). -Използвайки =[единствено]= апроксимацията на Бхаскара 1ви, пресметнете `[tg(α + β)]`.\n -=[Не може да използвате коренуване!]= +Използвайки [=единствено=] апроксимацията на Бхаскара 1ви, пресметнете [`tg(α + β)`].\n +[=Не може да използвате коренуване!=] За константата π, използвайте поне 5 цифри след десетичната запетая. .text
-*[Подсказка]* +[*Подсказка*] Използвайте факта, че [url https://en.wikipedia.org/wiki/List_of_trigonometric_identities#Shifts_and_periodicity може да представите косинус чрез отместване на синус].
@@ -404,7 +404,7 @@ pi / 8 = 0.392698 Примерно, числото 2148271109 в двоичната бройна система е 10000000000011000000010000000101, което се разделя на подчислата 10000000, 00001100, 00000100 и 00000101 (128, 12, 4 и 5). Получавате две 32-битови цели неотрицателни числа. -Сумирайте =[съответните]= подчисла в двете числа и изкарайте резултаното "надчисло". +Сумирайте [=съответните=] подчисла в двете числа и изкарайте резултаното "надчисло". :table_2 |= Вход @@ -474,7 +474,7 @@ pi / 8 = 0.392698 ### Задача 15 -В модерния интернет, всяко устройство се обозначава с *[уникален]* адрес. +В модерния интернет, всяко устройство се обозначава с [*уникален*] адрес. Това е 32-битово цяло неотрицателно число. За човешко удобоство, това число се представя чрез "dot-decimal notation": всеки 8 бита се представят като десетично число и тези 4 числа се слепват с точки между тях. diff --git a/src/teaching/upp-2025/week04/index.du b/src/teaching/upp-2025/week04/index.du index e803f2e..8b138fa 100644 --- a/src/teaching/upp-2025/week04/index.du +++ b/src/teaching/upp-2025/week04/index.du @@ -9,7 +9,7 @@ GitHub Classroom: [url https://classroom.github.com/a/rOzekyCs] :important .p -При `[if]`-ове =[ще]= вземаме точки за изрази от типа: +При [`if`]-ове [=ще=] вземаме точки за изрази от типа: ```c++ if (condition) @@ -122,11 +122,11 @@ else .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week04/Exercise04.cpp Решение] -От входа получавате реални коефициенти на квадратно уравнение: `[a]`, `[b]` и `[c]`. +От входа получавате реални коефициенти на квадратно уравнение: [`a`], [`b`] и [`c`]. Трябва да изкарате корените на уравнението, като: .bulleted - ако има два корена, изкарвате и двата, -- ако има един корен, изкарвате =[само]= него, +- ако има един корен, изкарвате [=само=] него, - ако няма реални корени, изкарвате "No real roots". :table_2 @@ -149,11 +149,11 @@ else От входа получавате буква, съответстваща на операция върху числа: .bulleted -- `[_]` за закръгляне надолу на число -- `[+]` за събиране на две числа -- `[*]` за умножение на две числа -- `[x]` за умножение на три числа -- `[.]` за умножение на четири числа +- [`_`] за закръгляне надолу на число +- [`+`] за събиране на две числа +- [`*`] за умножение на две числа +- [`x`] за умножение на три числа +- [`.`] за умножение на четири числа След тази буква ще получите съответния брой реални числа и трябва да изкарате резултата от операцията. @@ -184,9 +184,9 @@ else От входа получавате число, което определя фигура. Това число може да бъде: .bulleted -- `[1]` за окръжност, -- `[2]` за правоъгълник и -- `[3]` за триъгълник. +- [`1`] за окръжност, +- [`2`] за правоъгълник и +- [`3`] за триъгълник. Спрямо типа фигура, ще приемете различен брой реални числа: .bulleted @@ -218,7 +218,7 @@ else От входа получавате цяло число. Изкарайте за него таблицата на умножение от 1 до 10 включително. -=[Използвайте цикъл!]= +[=Използвайте цикъл!=] :table_2 |= Вход @@ -257,8 +257,8 @@ else .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week04/Exercise08.cpp Решение] -От входа получавате две цели положителни числа, `[a]` и `[x]`. -Пресметнете `[a]` на степен `[x]`. +От входа получавате две цели положителни числа, [`a`] и [`x`]. +Пресметнете [`a`] на степен [`x`]. :table_2 |= Вход @@ -282,7 +282,7 @@ else .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week04/Exercise09.cpp Решение] От входа получавате цяло положително число. -Трябва =[поотделно]= да сумирате всички четни и нечетни числа от 1 до подаденото число, включително. +Трябва [=поотделно=] да сумирате всички четни и нечетни числа от 1 до подаденото число, включително. Накрая изкарайте двете суми. :table_2 @@ -350,12 +350,12 @@ else От входа получавате знак. -Ако този знак е аритметична операция (`[+]`, `[-]`, `[*]`, `[/]`), тогава ще получите две цели числа. +Ако този знак е аритметична операция ([`+`], [`-`], [`*`], [`/`]), тогава ще получите две цели числа. Трябва да пресметнете резултата на операцията върху тези числа, да го изкарате и пак да очаквате знак. Ако този знак е точка, тогава спирате програмата. -*[При вас вход и изход ще са смесени.]* +[*При вас вход и изход ще са смесени.*] :table_2 |= Вход @@ -542,7 +542,7 @@ else Ако е по-голямо, трябва да върнете "Lower". Ако бъде познато, трябва да върнете "You guessed it!" и да спрете програмата. -*[В следните примери числото е 1337. Вашия вход и изход ще бъдат смесени.]* +[*В следните примери числото е 1337. Вашия вход и изход ще бъдат смесени.*] :table_2 |= Вход @@ -613,7 +613,7 @@ You guessed it! От входа получавате реално ненулево "целево" число и реално "обсег" число (в проценти). След това получавате редица реални ненулеви числа. -Продължавате да приемате реални числа, докато сумата на всички числа в редицата не е поне с "обсег" процента *[близкост]* до целевото число. +Продължавате да приемате реални числа, докато сумата на всички числа в редицата не е поне с "обсег" процента [*близкост*] до целевото число. Накрая на програмата изкарайте тази сума. Формулата за процентова разлика между числа а и b е: diff --git a/src/teaching/upp-2025/week05/index.du b/src/teaching/upp-2025/week05/index.du index a0bfe7f..f19ff04 100644 --- a/src/teaching/upp-2025/week05/index.du +++ b/src/teaching/upp-2025/week05/index.du @@ -78,7 +78,7 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] Трябва да върнете [url https://en.wikipedia.org/wiki/Factorial#Definition факториел] от първото число, който факториел е повдигнат на степен второто число. Факториел на едно (неотрицателно цяло) число е умножението на всички цели числа от 1 до самото число включително. -Примерно, факториел от 5 е `[1 * 2 * 3 * 4 * 5 = 120]`. +Примерно, факториел от 5 е [`1 * 2 * 3 * 4 * 5 = 120`]. :table_2 |= Вход @@ -134,7 +134,7 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] Последователност от числа, която съдържа еднакви числа, също се зачита за сортирана в нарастващ ред. .note -=[(01.11.2025)]= Поправен е изхода в първия пример, от 6 на 8. +[=(01.11.2025)=] Поправен е изхода в първия пример, от 6 на 8. :table_2 |= Вход @@ -206,7 +206,7 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week05/Exercise08.cpp Решение] От входа получавате две редици от по 10 реални числа (т.е. първите 10 числа са от първата редица, и вторите 10 числа образуват втората редица). -След това получавате знак - аритметича операция (`[+]`, `[-]`, `[*]`, `[/]`). +След това получавате знак - аритметича операция ([`+`], [`-`], [`*`], [`/`]). Трябва да изпълните операцията върху всяка съответна двойка числа от двете редици и да върнете резултатите. @@ -293,7 +293,7 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] .numbered 1. От ляво на дясно, трябва да умножите всяка цифра със съответната си "тежест": 8, 6, 4, 2, 3, 5, 9, 7 2. Сумирате умножените цифри -3. Пресмятате контролната цифра по формулата: `[11 - <сума> mod 11]`, където +3. Пресмятате контролната цифра по формулата: [`11 - <сума> mod 11`], където ако резултата е 10, цифрата е 0 и ако резултата е 11, цифрата е 5. :table_2 @@ -331,10 +331,10 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] От входа получавате цяло неотрицателно число. -Изкарвате [url https://en.wikipedia.org/wiki/Lucas_number числото на Лукас] след толкова на брой позиции и ако числото =[не]= е било 0, приемаме ново число и повтаряте логиката. +Изкарвате [url https://en.wikipedia.org/wiki/Lucas_number числото на Лукас] след толкова на брой позиции и ако числото [=не=] е било 0, приемаме ново число и повтаряте логиката. -Тоест, ако първото число е n, тогава връщате `[n]`-тото число на Лукас.\n -Ако второто число е m, тогава връщате `[n + m]`-тото число на Лукас. +Тоест, ако първото число е n, тогава връщате [`n`]-тото число на Лукас.\n +Ако второто число е m, тогава връщате [`n + m`]-тото число на Лукас. И така нататък. Числата на Лукас се определят по следния начин: @@ -342,9 +342,9 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] [image ./img/lucas_def.png] .note -=[(01.11.2025)]= Входа на последния пример е поправен. +[=(01.11.2025)=] Входа на последния пример е поправен. -*[Вашия вход и изход може да са смесени!]* +[*Вашия вход и изход може да са смесени!*] :table_2 |= Вход @@ -384,7 +384,7 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] Ако се поражда цикъл (посетим някое число повече от един път), тогава трябва да изкарате "Infinity". .note -=[(01.11.2025)]= Входа на първия пример е поправен. +[=(01.11.2025)=] Входа на първия пример е поправен. :table_2 |= Вход @@ -549,7 +549,7 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week05/Exercise18.cpp Решение] .note -=[(01.11.2025)]= Поправени бройката на входните цели числа и втория пример. +[=(01.11.2025)=] Поправени бройката на входните цели числа и втория пример. От входа получавате 7 цели числа. @@ -607,15 +607,15 @@ GitHub Classroom: [url https://classroom.github.com/a/6oPRMxJx] 1. Най-дясната цифра е "цифра за проверка", тя трябва да бъде изкарана за после. 2. Започвайки от най-дясната цифра (от останалите цифри, т.е. втората най-дясна в числото), трябва да умножите всяка втора цифра по две. - Ако цифрата стане по-голяма от 9, трябва да *[извадите]* 9. + Ако цифрата стане по-голяма от 9, трябва да [*извадите*] 9. 3. Сумирате всички цифри (всички умножени и неумножени). -4. Проверявате дали цифрата за проверка е равна на `[(10 - (сумa mod 10)) mod 10]` +4. Проверявате дали цифрата за проверка е равна на [`(10 - (сумa mod 10)) mod 10`] Този алгоритъм се използва главно в проверката на номера на дебитни/кредитни карти. Главната цел е да се засекат някои механични грешки при въвеждане на номера. .note -=[(01.11.2025)]= Поправен е входа на третия пример. +[=(01.11.2025)=] Поправен е входа на третия пример. :table_2 |= Вход @@ -651,7 +651,7 @@ n-тото число на Каталан се дефинира по следн [image ./img/catalan_def.png] -Където `[x!]` е [url https://en.wikipedia.org/wiki/Factorial#Definition факториел] от x. +Където [`x!`] е [url https://en.wikipedia.org/wiki/Factorial#Definition факториел] от x. Припомняме, че факториел на едно число е умножението на всички цели числа от 1 до самото число включително. :table_2 diff --git a/src/teaching/upp-2025/week06/index.du b/src/teaching/upp-2025/week06/index.du index d6c4b18..a1660f8 100644 --- a/src/teaching/upp-2025/week06/index.du +++ b/src/teaching/upp-2025/week06/index.du @@ -19,7 +19,7 @@ GitHub Classroom: [url https://classroom.github.com/a/JSB1UK_f] What is the smallest positive integer whose square ends in the digits 269,696? Според него това число е 99736 (чиито квадрат е 9947269696). -Напишете програма, която =[намира]= най-малкото число, отговарящо на въпроса. +Напишете програма, която [=намира=] най-малкото число, отговарящо на въпроса. :table_2 |= Вход @@ -116,7 +116,7 @@ What is the smallest positive integer whose square ends in the digits 269,696? [image ./img/rectangle_and_line.png] изкарайте дали точката е в защрихованата област или не. -Областта =[не]= включва правата и правоъгълника! +Областта [=не=] включва правата и правоъгълника! Зачитайте, че черните прави отбелязват главните оси, а разстоянията между съседни сиви оси е единица. @@ -238,7 +238,7 @@ What is the smallest positive integer whose square ends in the digits 269,696? [image ./img/two_circles.png] изкарайте дали точката е в защрихованата област или не. -Областта =[не]= включва самите окръжности! +Областта [=не=] включва самите окръжности! Зачитайте, че черните прави отбелязват главните оси, а разстоянията между съседни сиви оси е единица. @@ -317,7 +317,7 @@ What is the smallest positive integer whose square ends in the digits 269,696? От входа получавате четири трицифрени цели неотрицателн числа. Трябва да върнете най-голямото възможно цяло число, което се получава след "слепване" на тези числа. -*[Не е нужно да използвате сортиращ алгоритъм!]* +[*Не е нужно да използвате сортиращ алгоритъм!*] :table_2 |= Вход @@ -342,7 +342,7 @@ What is the smallest positive integer whose square ends in the digits 269,696? [image ./img/triangle_and_circle.png] -Областта =[не]= включва правата и правоъгълника! +Областта [=не=] включва правата и правоъгълника! Зачитайте, че черните прави отбелязват главните оси, а разстоянията между съседни сиви оси е единица. @@ -544,10 +544,10 @@ What is the smallest positive integer whose square ends in the digits 269,696? .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week06/Exercise17.cpp Решение] -От входа получавате две естествени числа, `[a]` и `[b]`. -Трябва да върнете дали `[a]` е [url https://en.wikipedia.org/wiki/Unitary_divisor унитарен делител] на `[b]`. +От входа получавате две естествени числа, [`a`] и [`b`]. +Трябва да върнете дали [`a`] е [url https://en.wikipedia.org/wiki/Unitary_divisor унитарен делител] на [`b`]. -Това е изпълнено, когато `[a]` е делител на `[b]` и най-големия общ делител на `[a]` и `[b / a]` е 1. +Това е изпълнено, когато [`a`] е делител на [`b`] и най-големия общ делител на [`a`] и [`b / a`] е 1. :table_2 |= Вход @@ -574,7 +574,7 @@ What is the smallest positive integer whose square ends in the digits 269,696? .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week06/Exercise18.cpp Решение] От входа получавате 10 реални числа. -Трябва да върнете най-голямата възможна сума, получена чрез събиране на колкото и дълга =[последователна]= редица от елементи. +Трябва да върнете най-голямата възможна сума, получена чрез събиране на колкото и дълга [=последователна=] редица от елементи. :table_2 |= Вход diff --git a/src/teaching/upp-2025/week07/index.du b/src/teaching/upp-2025/week07/index.du index b23dcd5..3f671b0 100644 --- a/src/teaching/upp-2025/week07/index.du +++ b/src/teaching/upp-2025/week07/index.du @@ -9,7 +9,7 @@ GitHub Classroom: [url https://classroom.github.com/a/clYBilXQ] :important -.p Както при `[if]`-ове, следното е лоша практика и ще се вземат точки: +.p Както при [`if`]-ове, следното е лоша практика и ще се вземат точки: ```c++ bool f() { @@ -22,7 +22,7 @@ bool f() { :important -.p Следното е =[грешно]= и ще се вземат точки: +.p Следното е [=грешно=] и ще се вземат точки: ```c++ int* f() { @@ -44,7 +44,7 @@ int* f() { bool evenAndPositive(int x); От входа получавате цяло число. -Използвайки `[evenAndPositive]`, върнете дали е четно и положително. +Използвайки [`evenAndPositive`], върнете дали е четно и положително. :table_2 |= Вход @@ -64,7 +64,7 @@ bool evenAndPositive(int x); .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week07/Exercise02.cpp Решение] -Напишете функция, която приема цяло неотрицателно число `[n]` и връща n-тото число на фибоначи. +Напишете функция, която приема цяло неотрицателно число [`n`] и връща n-тото число на фибоначи. Припомняме, че нулевото число на фибоначи е 0, първото число е 1 и всяко следващо е сумата на предходните две. Нека вашата функция да следва декларацията: @@ -73,7 +73,7 @@ bool evenAndPositive(int x); unsigned int fib(unsigned int n); От входа получавате цяло неотрицателно число. -Използвайки `[fib]`, трябва да изкарате n-тото число на фибоначи. +Използвайки [`fib`], трябва да изкарате n-тото число на фибоначи. :table_2 |= Вход @@ -109,10 +109,10 @@ unsigned int fib(unsigned int n); double average(int numbers[15]); От входа получавате 15 цели числа. -Използвайки `[average]`, трябва да изкарате средното аритметично на всички тях. +Използвайки [`average`], трябва да изкарате средното аритметично на всички тях. .note -*[(14.11.2025)]* Оправен изхода на втори пример. +[*(14.11.2025)*] Оправен изхода на втори пример. :table_2 |= Вход @@ -132,7 +132,7 @@ double average(int numbers[15]); .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week07/Exercise04.cpp Решение] -Напишете функция, която приема число с плаваща запетая и *[връща]* две числа: +Напишете функция, която приема число с плаваща запетая и [*връща*] две числа: .numbered 1. числото, разделено на половина и 2. числото, закръглено надолу към най-близкото цяло число. @@ -143,7 +143,7 @@ double average(int numbers[15]); void calc(float number, double &half, int* integer); От входа получавате число с плаваща запетая. -Използвайки `[calc]`, трябва да изкарате двете *[върнати]* стойности. +Използвайки [`calc`], трябва да изкарате двете [*върнати*] стойности. :table_2 |= Вход @@ -160,13 +160,13 @@ void calc(float number, double &half, int* integer); .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week07/Exercise05.cpp Решение] -Напишете функция `[maxElem]`, която приема масив от числа с плаваща запетая и негов размер =[поотделно]=! +Напишете функция [`maxElem`], която приема масив от числа с плаваща запетая и негов размер [=поотделно=]! Това означава, че на функцията може да ѝ бъде подаден масив с 10, 15, 2 или ... елемента. Нека вашата функция да върне най-големия елемент в масива. От входа получавате една редица от 5 реални числа и втора редица от 7 реални числа. -Използвайки `[maxElem]`, върнете най-големия елемент в първата и във втората редица. +Използвайки [`maxElem`], върнете най-големия елемент в първата и във втората редица. :table_2 |= Вход @@ -191,14 +191,14 @@ void calc(float number, double &half, int* integer); .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week07/Exercise06.cpp Решение] -Напишете функция, която приема масив с произволна дължина (масива и размера се подават поотделно), съствен от цели числа, и *[върнете]* най-големия и най-малкия му елемент. +Напишете функция, която приема масив с произволна дължина (масива и размера се подават поотделно), съствен от цели числа, и [*върнете*] най-големия и най-малкия му елемент. Нека вашата функция да следва декларацията: ```c++ void minmaxElems(int* arr, unsigned size, int* min, int* max); От входа получавате две редици от по 10 и 8 цели числа съответно. -Използвайки `[minmaxElems]`, върнете най-големия и най-малкия елемент на всяка редица. +Използвайки [`minmaxElems`], върнете най-големия и най-малкия елемент на всяка редица. :table_2 |= Вход @@ -236,12 +236,12 @@ void minmaxElems(int* arr, unsigned size, int* min, int* max); unsigned sumElems(int* arr, unsigned size); От входа получавате 11 цели числа. -Трябва да върнете първата последователност от 3 елемента, чиято сума е 0, използвайки `[sumElems]`. +Трябва да върнете първата последователност от 3 елемента, чиято сума е 0, използвайки [`sumElems`]. Ако няма такава, не изкарвайте нищо. .note -*[(14.11.2025)]* Оправен изхода на трети пример. +[*(14.11.2025)*] Оправен изхода на трети пример. :table_2 |= Вход @@ -264,11 +264,11 @@ unsigned sumElems(int* arr, unsigned size); Напишете функция, която приема масив с произволен размер, съставен от цели неотрицателни числа, и неотрицателно число: ротация. Трябва да завъртите елементите в масива с ротация на брой позиции на дясно. -Тоест, ако масива е `[1 2 3 4]`, тогава след ротация с една позиция, масива ще е `[4 1 2 3]`. -Ако имахме две ротации, тогава щяхме да получим `[3 4 1 2]`. +Тоест, ако масива е [`1 2 3 4`], тогава след ротация с една позиция, масива ще е [`4 1 2 3`]. +Ако имахме две ротации, тогава щяхме да получим [`3 4 1 2`]. Не модифицирайте оригиналния масив! -Трябва да *[върнете]* друг масив със завъртяните елементи. +Трябва да [*върнете*] друг масив със завъртяните елементи. От входа получавате две редици от по 6 и 7 цели числа. След всяка редица получавате ротация. @@ -304,10 +304,10 @@ unsigned sumElems(int* arr, unsigned size); .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week07/Exercise09.cpp Решение] .note -*[(14.11.2025)]* Оправена декларацията на функцията, примери и добавено упътване. +[*(14.11.2025)*] Оправена декларацията на функцията, примери и добавено упътване. .warn -НЕ може да използвате "вградената" функция `[pow]`! +НЕ може да използвате "вградената" функция [`pow`]! Напишете функция, която приема число с плаваща запетая и цяло неотрицателно число, и връща първото число на степен второто. Нека вашата функция да следва декларацията: @@ -319,13 +319,13 @@ double topower(double x, unsigned int a); Първите 10 са коефициентите в полином от 10та степен. 11тото е потенциален корен. -Трябва да върнете дали 11тото действително е корен на уравнението, използвайки `[topower]`. +Трябва да върнете дали 11тото действително е корен на уравнението, използвайки [`topower`]. -Припомняме, че едно число `[x]` е корен на полином от 10та степен, когато: +Припомняме, че едно число [`x`] е корен на полином от 10та степен, когато: [image ./img/polynomial.png] -=[Упътване:]= +[=Упътване:=] За някои примери, прецизността на въведения корен не е достатъчна. Може да приемете, че ако (абсолютната стойност на) сумата е по-малка от 0.0001, то сумата на практика е 0. @@ -371,10 +371,10 @@ double topower(double x, unsigned int a); unsigned int countSameElementsOnSameIndecies(int* arr1, unsigned int size1, int* arr2, unsigned int size2); От входа получавате две редици от по 10 и 15 цели числа. -Трябва да върнете бройката на съвпадащи стойности на съвпадащи индекси, използвайки `[countSameElementsOnSameIndecies]`. +Трябва да върнете бройката на съвпадащи стойности на съвпадащи индекси, използвайки [`countSameElementsOnSameIndecies`]. .note -*[14.11.2025]* Оправен вход на последния пример. +[*14.11.2025*] Оправен вход на последния пример. :table_2 |= Вход @@ -470,7 +470,7 @@ unsigned int countSameElementsOnSameIndecies(int* arr1, unsigned int size1, int* От входа получавате 12 букви и трябва да върнете дали целия масив образува последователността "буква, цифра, буква, цифра, буква, цифрва, ...", използвайки вашата функция. .note -*[(14.11.2025)]* Оправен трети пример. +[*(14.11.2025)*] Оправен трети пример. :table_2 |= Вход @@ -490,15 +490,15 @@ unsigned int countSameElementsOnSameIndecies(int* arr1, unsigned int size1, int* .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week07/Exercise14.cpp Решение] -Напишете функция, която получава масив от 10 реални числа и *[връща]* масив от 5 реални числа. +Напишете функция, която получава масив от 10 реални числа и [*връща*] масив от 5 реални числа. Резултатния масив се формира по следния начин: .numbered -1. Първия елемент на *[върнатия]* масив е разликата на втория от първия елемент на входния (получения) масив. -2. Втория елемент на *[върнатия]* масив е разликата на четвъртия от третия елемент на входния масив. +1. Първия елемент на [*върнатия*] масив е разликата на втория от първия елемент на входния (получения) масив. +2. Втория елемент на [*върнатия*] масив е разликата на четвъртия от третия елемент на входния масив. 3. И така нататък. От входа получавате масив с 10 елемента. -Трябва да *[върнете]* резултатния 5-елементен масив от вашата функция. +Трябва да [*върнете*] резултатния 5-елементен масив от вашата функция. :table_2 |= Вход @@ -532,7 +532,7 @@ unsigned int countSameElementsOnSameIndecies(int* arr1, unsigned int size1, int* Допуснете, че винаги ще срещнете целевото число. Използвайте вашите функции. .note -*[(14.11.2025)]* Оправени входове на първите два примера. +[*(14.11.2025)*] Оправени входове на първите два примера. :table_2 |= Вход diff --git a/src/teaching/upp-2025/week08/index.du b/src/teaching/upp-2025/week08/index.du index 9fd0260..4b75284 100644 --- a/src/teaching/upp-2025/week08/index.du +++ b/src/teaching/upp-2025/week08/index.du @@ -14,7 +14,7 @@ GitHub Classroom: [url https://classroom.github.com/a/rhpKbNmH] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week08/Exercise01.cpp Решение] От входа получавате матрица 5 на 5 от цели числа. -Трябва да върнете дали е разредена матрица: дали има *[повече]* нули отколкото други числа. +Трябва да върнете дали е разредена матрица: дали има [*повече*] нули отколкото други числа. :table_2 |= Вход @@ -100,12 +100,12 @@ Sparse Тоест, всички елементи от горния ляв ъгъл, надолу и надясно колкото е размера на втората матрица. От входа получавате матрица 6 на 6 от реални числа. -След това получавате 4 неотрицателни числа: първите две са координат в матрицата (където горния ляв ъгъл е `[(0, 0)]`), вторите две са нейни размери. +След това получавате 4 неотрицателни числа: първите две са координат в матрицата (където горния ляв ъгъл е [`(0, 0)`]), вторите две са нейни размери. -Използвайки вашата функция, трябва да изкарате подматрицата с начало подадения координат и размери подадените размери =[използвайки]= вашата функция. +Използвайки вашата функция, трябва да изкарате подматрицата с начало подадения координат и размери подадените размери [=използвайки=] вашата функция. .note -=[(23.11.2025)]= Опростени някои примери. +[=(23.11.2025)=] Опростени някои примери. :table_2 |= Вход @@ -189,12 +189,12 @@ City Bloxx е известна мобилна игра за строене на Нека да разгледаме следните правила за сгради (в самата игра има някои разлики): .numbered -1. *[Жилищните сгради]* може да се поставят навсякъде. -2. *[Търговските сгради]* трябва да бъдат поставени до поне една жилищна сграда. -3. *[Офис сградите]* трябва да бъдат поставени до поне една жилищна и една търговска. -4. *[Луксозните сгради]* трябва да бъдат поставени до поне една жилищна, една търговска и една офис сграда. +1. [*Жилищните сгради*] може да се поставят навсякъде. +2. [*Търговските сгради*] трябва да бъдат поставени до поне една жилищна сграда. +3. [*Офис сградите*] трябва да бъдат поставени до поне една жилищна и една търговска. +4. [*Луксозните сгради*] трябва да бъдат поставени до поне една жилищна, една търговска и една офис сграда. -Сгради са съседни само по вертикал и хоризонтал, =[не]= по диагонал. +Сгради са съседни само по вертикал и хоризонтал, [=не=] по диагонал. От входа получавате масив 5 на 5 с цели числа, където с 1 до 4 се обозначават сградите, от жилищни до луксозни. Изкарайте дали подредбата на сградите е позволена (следва горните правила). @@ -302,7 +302,7 @@ City Bloxx е известна мобилна игра за строене на Трябва да размените двете колони, използвайки вашата функция, и да изкарате резултата. -*[Вашия изход не е нужно да бъде подравнен.]* +[*Вашия изход не е нужно да бъде подравнен.*] :table_2 |= Вход @@ -353,10 +353,10 @@ City Bloxx е известна мобилна игра за строене на .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week08/Exercise07.cpp Решение] От входа получавате матрица от букви 3 на 3. -Тя определя шаблон, където буквата `[*]` означава, че всяка стойност е позволена. +Тя определя шаблон, където буквата [`*`] означава, че всяка стойност е позволена. След това от входа получавате матрица 6 на 6, съствена от букви. -Трябва да намерите всички срещания на шаблона в тази матрица, като =[срещанията може да се застъпват!]= +Трябва да намерите всички срещания на шаблона в тази матрица, като [=срещанията може да се застъпват!=] :table_2 |= Вход @@ -427,7 +427,7 @@ City Bloxx е известна мобилна игра за строене на Пресметнете умножението на матриците (ред по стълб) и изкарайте резултата. .note -=[(23.11.2025)]= Оправен входа на втория пример. +[=(23.11.2025)=] Оправен входа на втория пример. :table_2 |= Вход @@ -469,9 +469,9 @@ City Bloxx е известна мобилна игра за строене на .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week08/Exercise09.cpp Решение] При изграждането на устройства като клавиатури, често се използва "бутонна матрица". -Няма да навлизаме в електрониката, но идеята е че когато натиснеш бутон, съответната колона =[и]= ред са "свързани"/активни. +Няма да навлизаме в електрониката, но идеята е че когато натиснеш бутон, съответната колона [=и=] ред са "свързани"/активни. -=[Тоест, когато активни ред и колона се пресичат, тогава съответния бутон е натиснат.]= +[=Тоест, когато активни ред и колона се пресичат, тогава съответния бутон е натиснат.=] Това означава, че се нуждаем да погледнем само състоянията на всеки ред и колона, и ще знаем всички натиснати бутони (вместо да поглеждаме всеки бутон поотделно). @@ -484,7 +484,7 @@ City Bloxx е известна мобилна игра за строене на От входа първо получавате 4 булеви стойности: дали реда е активен (отгоре надолу). След това получавате още 3 булеви стойности: дали колоната е активна (отляво надясно). -Изкарайте кои бутони са натиснати, използвайки цифровите знаци, звезда (`[*]`) и диез (`[#]`). +Изкарайте кои бутони са натиснати, използвайки цифровите знаци, звезда ([`*`]) и диез ([`#`]). Ако няма натиснати, изкарайте съответно съобщение. :table_2 @@ -523,26 +523,26 @@ City Bloxx е известна мобилна игра за строене на [image https://upload.wikimedia.org/wikipedia/commons/0/0d/PascalTriangleAnimated2.gif] -=[Генерирайте]= и изкарайте триъгълника на паскал в матрица 11 на 11, където двете страни на триъгълника са първата колона и главния диагонал. +[=Генерирайте=] и изкарайте триъгълника на паскал в матрица 11 на 11, където двете страни на триъгълника са първата колона и главния диагонал. Нека стойностите извън триъгълника да са нули. -=[Изход:]= *[(не е нужно да бъде подравнен)]* +[=Изход:=] [*(не е нужно да бъде подравнен)*] .comment https://www.fcfung2000.com/ufcfiles/ufcmatrk.htm ``` -=[1]= 0 0 0 0 0 0 0 0 0 0 -=[1]= =[1]= 0 0 0 0 0 0 0 0 0 -=[1]= 2 =[1]= 0 0 0 0 0 0 0 0 -=[1]= 3 3 =[1]= 0 0 0 0 0 0 0 -=[1]= 4 6 4 =[1]= 0 0 0 0 0 0 -=[1]= 5 10 10 5 =[1]= 0 0 0 0 0 -=[1]= 6 15 20 15 6 =[1]= 0 0 0 0 -=[1]= 7 21 35 35 21 7 =[1]= 0 0 0 -=[1]= 8 28 56 70 56 28 8 =[1]= 0 0 -=[1]= 9 36 84 126 126 84 36 9 =[1]= 0 -=[1]= 10 45 120 210 252 210 120 45 10 =[1]= +[=1=] 0 0 0 0 0 0 0 0 0 0 +[=1=] [=1=] 0 0 0 0 0 0 0 0 0 +[=1=] 2 [=1=] 0 0 0 0 0 0 0 0 +[=1=] 3 3 [=1=] 0 0 0 0 0 0 0 +[=1=] 4 6 4 [=1=] 0 0 0 0 0 0 +[=1=] 5 10 10 5 [=1=] 0 0 0 0 0 +[=1=] 6 15 20 15 6 [=1=] 0 0 0 0 +[=1=] 7 21 35 35 21 7 [=1=] 0 0 0 +[=1=] 8 28 56 70 56 28 8 [=1=] 0 0 +[=1=] 9 36 84 126 126 84 36 9 [=1=] 0 +[=1=] 10 45 120 210 252 210 120 45 10 [=1=] ### Задача 11 @@ -559,9 +559,9 @@ City Bloxx е известна мобилна игра за строене на Не добавяйте към средното аритметично несъществуващи клетки (напр. клетката в горния ляв ъгъл няма клетки над или в ляво от себе си). .note -=[(23.11.2025)]= Добавени още примери. +[=(23.11.2025)=] Добавени още примери. -*[(Вашия изход не е нужно да бъде подравнен.)]* +[*(Вашия изход не е нужно да бъде подравнен.)*] :table_2 |= Вход @@ -655,7 +655,7 @@ City Bloxx е известна мобилна игра за строене на От входа получавате два реални координата, между (0,0) и (10,10). -Трябва да върнете матрица 10 на 10 от знаци, която се съставя единствено от шпации (spaces) и хиксове (`[x]`). +Трябва да върнете матрица 10 на 10 от знаци, която се съставя единствено от шпации (spaces) и хиксове ([`x`]). Зачитаме, че координатите директно съответстват на матрицата, като (0,0) се намира в горния ляв ъгъл и (10,10) в долния десен. В тази матрица, по подразбиране стоят само шпации. @@ -667,7 +667,7 @@ City Bloxx е известна мобилна игра за строене на Тази операция се нарича интерполация. .note -=[(23.11.2025)]= Добавени още примери. +[=(23.11.2025)=] Добавени още примери. :table_2 |= Вход @@ -867,7 +867,7 @@ City Bloxx е известна мобилна игра за строене на Ако не можете, не записвайте нищо във върнатата. От входа получавате матрица 4 на 8, съставена от цели числа. -=[Използвайки вашата функция]=, завъртете матрицата и изкарайте резултата. +[=Използвайки вашата функция=], завъртете матрицата и изкарайте резултата. :table_2 |= Вход @@ -1022,7 +1022,7 @@ City Bloxx е известна мобилна игра за строене на ### Задача 20 -=[Генерирайте]= и изкарайте [url https://en.wikipedia.org/wiki/Bell_triangle триъгълника на Бел] в долния ляв ъгъл на матрица 11 на 11. +[=Генерирайте=] и изкарайте [url https://en.wikipedia.org/wiki/Bell_triangle триъгълника на Бел] в долния ляв ъгъл на матрица 11 на 11. Това означава, че страните на триъгълника включват първата колона и главния диагонал. .bulleted @@ -1039,7 +1039,7 @@ City Bloxx е известна мобилна игра за строене на Тази задача е подобна на [url #-10 Задача 10]. -=[Изход:]= *[(не е нужно да бъде подравнен)]* +[=Изход:=] [*(не е нужно да бъде подравнен)*] .comment https://oeis.org/A011971 @@ -1108,9 +1108,9 @@ https://www.apcomputersciencetutoring.com/2d-array-practice-exercises/#grow-meth Трябва да изкарате матрица със знаци 9 на 9, в която е попълнено изображението спрямо режима. .numbered -1. =[Режим 1]= обозначава повтаряне, където изображението се повтаря последователно -2. =[Режим 2]= обозначава "border", където изображението се слага в центъра и останалта част се попълва със знак диес `[#]`. -3. =[Режим 3]= обозначава "clamp", изображението се слага в центъра и останалата част се попълва като се повтаря последната буква. Тоест, дясното 3 на 3 се попълва с повторение на десния знак. +1. [=Режим 1=] обозначава повтаряне, където изображението се повтаря последователно +2. [=Режим 2=] обозначава "border", където изображението се слага в центъра и останалта част се попълва със знак диес [`#`]. +3. [=Режим 3=] обозначава "clamp", изображението се слага в центъра и останалата част се попълва като се повтаря последната буква. Тоест, дясното 3 на 3 се попълва с повторение на десния знак. :table_2 |= Вход @@ -1181,7 +1181,7 @@ f f f g g g h h h Зачитайте, че 0 винаги е в центъра на спиралата и се въртите първо с една позиция разстояние, после с две и так. нат. -*[(Вашия изход не е нужно да бъде подравнен.)]* +[*(Вашия изход не е нужно да бъде подравнен.)*] :table_2 |= Вход @@ -1222,15 +1222,15 @@ f f f g g g h h h Реализирайте матричен калкулатор. От входа получавате матрица 4 на 4 с реални числа и след това получавате редица операции. -Всяка операция започва с буква, като буквата `[$]` сигнализира край на програмата. +Всяка операция започва с буква, като буквата [`$`] сигнализира край на програмата. След всеки знак има няколко аргумента, т.е. допълнителни стойности които трябва да се въведат, преди операцията да се изпълни. .bulleted -- Операцията `[*]` обозначава умножение на ред, и след знака има цяло неотрицателно число за индекс на ред и след него е реално число (коефициент с който да умножим реда). -- Операцията `[+]` обозначава сума на редове, след знака се очакват два неотрицателни индекса на редове, първия ред се сумира в втория -- Операцията `[^]` обозначава размяна на редове, след знака се очакват два неотрицателни индекса на редове и стойностите им се разменят. +- Операцията [`*`] обозначава умножение на ред, и след знака има цяло неотрицателно число за индекс на ред и след него е реално число (коефициент с който да умножим реда). +- Операцията [`+`] обозначава сума на редове, след знака се очакват два неотрицателни индекса на редове, първия ред се сумира в втория +- Операцията [`^`] обозначава размяна на редове, след знака се очакват два неотрицателни индекса на редове и стойностите им се разменят. -След всяка операция (освен `[$]`) трябва да изкарате състоянието на матрицата. +След всяка операция (освен [`$`]) трябва да изкарате състоянието на матрицата. ### Задача 25 @@ -1239,7 +1239,7 @@ f f f g g g h h h От входа получавате матрица 10 на 10 с булеви стойности. След това получавате неотрицателно число: брой генерации (ходове). -Всяка клетка наричаме жива или мъртва (съответно на `[true]` или `[false]`). +Всяка клетка наричаме жива или мъртва (съответно на [`true`] или [`false`]). В една генерация (ход) на играта, всяка клетка променя своя статус (стойност) по следните правила: .bulleted - всяка жива клетка с по-малко от два живи съседа (вертикално, хоризонтално и диагонално) умира diff --git a/src/teaching/upp-2025/week09/index.du b/src/teaching/upp-2025/week09/index.du index b204cd8..55febbf 100644 --- a/src/teaching/upp-2025/week09/index.du +++ b/src/teaching/upp-2025/week09/index.du @@ -30,9 +30,9 @@ GitHub Classroom: [url https://classroom.github.com/a/ZYFDdLi4] Всеки хигрометър измерва процента влажност. В условието не са дадени подробности относно формата на тази стойност, затова ще използваме тип с плаваща запетая, който ще покрие всички реални стойности. -Ще изведем в глобална константа `[SIZE]` размера на едно измерение на матрицата, и самата матрица ще съдържа влажността в стойности от тип `[double]`. +Ще изведем в глобална константа [`SIZE`] размера на едно измерение на матрицата, и самата матрица ще съдържа влажността в стойности от тип [`double`]. -За намиране на средната влажност в града, ще изградим функцията `[average]`, която изглежда по следния начин: +За намиране на средната влажност в града, ще изградим функцията [`average`], която изглежда по следния начин: ```c++ double average(const double hygrometers[SIZE][SIZE]); @@ -41,7 +41,7 @@ double average(const double hygrometers[SIZE][SIZE]); Реализацията изисква линейно итериране през цялата матрица, като се пази сума на всички елементи. Върнатата стойност е сумата, разделена на броя хигрометри. -За намиране на най-влажен и най-сух квадрант ще реализираме функцията `[quadrantHumidity]`, чиято декларация е: +За намиране на най-влажен и най-сух квадрант ще реализираме функцията [`quadrantHumidity`], чиято декларация е: ```c++ double quadrantHumidity(const double hygrometers[SIZE][SIZE], unsigned startRow, unsigned startCol); @@ -49,16 +49,16 @@ double quadrantHumidity(const double hygrometers[SIZE][SIZE], unsigned startRow, Функцията приема матрицата с влажности и начални индекси по ред и колона на съответния квадрант. Знаем, че един квадрант ще бъде една четвърт от размера на матрицата (половината височина и ширина), затова не е нужно той да бъде подаден. -В имплементацията, ще итерираме през матрицата, като започнем от началните редове и колона, и обиколим точно `[SIZE / 2]` реда и колони. +В имплементацията, ще итерираме през матрицата, като започнем от началните редове и колона, и обиколим точно [`SIZE / 2`] реда и колони. Ще пазим сума на всички елементи и накрая ще разделим на броя елементи, т.е. ще върнем средната стойност на влажност в квадранта. В заглавната функция ще дефинираме матрицата и ще попълним входните влажности. -След това ще изкараме стойността, върната от извикване на `[average]`. +След това ще изкараме стойността, върната от извикване на [`average`]. За сух и влажен квадрант, ще създадем две променливи за най-голяма и най-малка стойност. -След това ще извикваме `[quadrantHumidity]`, като ще запазим върната стойност като най-голяма и най-малка спрямо текущите стойности. +След това ще извикваме [`quadrantHumidity`], като ще запазим върната стойност като най-голяма и най-малка спрямо текущите стойности. -Началните ред и колона ще подаваме с вложен цикъл, който ще итерира колоните и редовете от най-първите (на индекси 0,0) и ще увеличава всеки индекс с размера на страната на квадрант (`[SIZE / 2]`). +Началните ред и колона ще подаваме с вложен цикъл, който ще итерира колоните и редовете от най-първите (на индекси 0,0) и ще увеличава всеки индекс с размера на страната на квадрант ([`SIZE / 2`]). След цикъла и всички извиквания ще имаме стойностите в нашите променливи и ще ги изкараме. diff --git a/src/teaching/upp-2025/week10/index.du b/src/teaching/upp-2025/week10/index.du index 34c4370..5ec2926 100644 --- a/src/teaching/upp-2025/week10/index.du +++ b/src/teaching/upp-2025/week10/index.du @@ -6,7 +6,7 @@ [$pagenav] .important -Едно от най-важните неща: =[всяка динамично-заделена памет трябва да се освободи преди края на програмата!]= +Едно от най-важните неща: [=всяка динамично-заделена памет трябва да се освободи преди края на програмата!=] GitHub Classroom: [url https://classroom.github.com/a/kDfmWmy7] @@ -37,7 +37,7 @@ GitHub Classroom: [url https://classroom.github.com/a/kDfmWmy7] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week10/Exercise02.cpp Решение] -Реализирайте функцията `[average]`, която приема масив, съставен от цели числа, с произволен размер, и връща средното аритметично на всички тези числа. +Реализирайте функцията [`average`], която приема масив, съставен от цели числа, с произволен размер, и връща средното аритметично на всички тези числа. От входа ще получите размер n и след това 2n на брой цели числа. Използвайки вашата функция, трябва да върнете средното аритметично на тези числа. @@ -55,7 +55,7 @@ GitHub Classroom: [url https://classroom.github.com/a/kDfmWmy7] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week10/Exercise03.cpp Решение] От входа получавате размерите на матрица, съставена от неотрицателни целочислени стойности, и след това всички стойности в самата матрица. -=[В паметта]= обърнете реда на редовете и изкарайте резултата. +[=В паметта=] обърнете реда на редовете и изкарайте резултата. .question Може ли да се направи по по-прост начин, отколкото ако матрицата беше статично-заделена? @@ -132,9 +132,9 @@ Cannot multiply! .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week10/Exercise05.cpp Решение] .note -*[(07.12.2025)]* Оправено условие и пример +[*(07.12.2025)*] Оправено условие и пример -Реализирайте функция `[largest]`, която приема матрица, съставена от цели числа, с произволни размери, и връща най-големия елемент в нея. +Реализирайте функция [`largest`], която приема матрица, съставена от цели числа, с произволни размери, и връща най-големия елемент в нея. От входа получавате две числа, размери на матрица, и след това всички елементи в матрицата. Използвайки вашата функция, върнете най-голямото число. @@ -190,7 +190,7 @@ Cannot multiply! След това получавате координат в дъската, трябва да върнете дали змията някога е посетила тази клетка. .note -*[(07.12.2025)]* Разменени ред и колона в примерите +[*(07.12.2025)*] Разменени ред и колона в примерите :table_2 |= Вход @@ -286,7 +286,7 @@ Cannot multiply! Трябва да върнете елементите по контура (краищата) на часовника, следвайки горното правило. .note -*[(07.12.2025)]* Поправен примера с четния размер +[*(07.12.2025)*] Поправен примера с четния размер :table_2 |= Вход @@ -336,7 +336,7 @@ Cannot multiply! Трябва да върнете дали числото е корен на съответния полином. .note -*[(07.12.2025)]* Поправени примерите с първа степен полином +[*(07.12.2025)*] Поправени примерите с първа степен полином :table_2 |= Вход @@ -400,24 +400,24 @@ Cannot multiply! След това влизате в "потребителски интерфейс", където от входа получавате буква, обозначаваща команда върху дневника. Командите са: .bulleted -- `[e]` обозначава край на програмата -- `[m]`, получавате индекс на ден и трябва да върнете максималната продажба в този ден -- `[M]`, трябва да върнете индекса на най-печелившия ден +- [`e`] обозначава край на програмата +- [`m`], получавате индекс на ден и трябва да върнете максималната продажба в този ден +- [`M`], трябва да върнете индекса на най-печелившия ден -=[Пример:]= *[(вход и изход са смесени, изходът е удебелен)]* +[=Пример:=] [*(вход и изход са смесени, изходът е удебелен)*] ``` 3 4 0.5 100 19.99 7 0 2 500 8 m 0 -=[100]= +[=100=] m 1 -=[0]= +[=0=] m 2 -=[500]= +[=500=] M -=[2]= +[=2=] e ### Задача 14 diff --git a/src/teaching/upp-2025/week11/index.du b/src/teaching/upp-2025/week11/index.du index 17bbd52..a381246 100644 --- a/src/teaching/upp-2025/week11/index.du +++ b/src/teaching/upp-2025/week11/index.du @@ -27,7 +27,7 @@ GitHub Classroom: [url https://classroom.github.com/a/z_C3UMi8] .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week11/Exercise01.cpp Решение] От входа получавате 20 буквен низ: име. -Трябва да изкарате съобщението "Hello *[[име]]*!" +Трябва да изкарате съобщението "Hello [*[име]*]!" :table_2 |= Вход @@ -69,19 +69,19 @@ GitHub Classroom: [url https://classroom.github.com/a/z_C3UMi8] Изключвайте крайната точка в бройката на полетата. .note -*[(14.12.2025)]* Добавени точки в края на изреченията. +[*(14.12.2025)*] Добавени точки в края на изреченията. :table_2 |= Вход |= Изход -|: `[first second third fourth.]` +|: [`first second third fourth.`] |: 4 -|: `[I'm glad you're here.]` +|: [`I'm glad you're here.`] |: 4 -|: `[ a b c d 8 k * * .]` +|: [` a b c d 8 k * * .`] |: 8 @@ -144,12 +144,12 @@ trail led eastward through the fat spruce timberland.\n .solution-link [url https://github.com/Syndamia/upp-2025-solutions/tree/main/Week11/Exercise06.cpp Решение] От входа получавате ред, обозначаващ число в 16-тича бройна система. -Тоест, реда започва с `[0x]` и останалото са 16-тични цифри. +Тоест, реда започва с [`0x`] и останалото са 16-тични цифри. -Трябва да изкарате стойността на числото в 10-тична бройна система, =[като направите конвертирането ръчно!]= -Тоест =[не е позволено да използвате функционалност от стандартната библиотека!]= +Трябва да изкарате стойността на числото в 10-тична бройна система, [=като направите конвертирането ръчно!=] +Тоест [=не е позволено да използвате функционалност от стандартната библиотека!=] -Приемете, че буквите A-F са главни и че няма да имате водещи нули (напр. `[0x0001]`). +Приемете, че буквите A-F са главни и че няма да имате водещи нули (напр. [`0x0001`]). :table_2 |= Вход @@ -315,7 +315,7 @@ Buffalo Buffalo Buffalo Накрая тряба да върнете оценката на паролата. .note -*[(14.12.2025)]* Оправени оценки в примерите +[*(14.12.2025)*] Оправени оценки в примерите :table_2 |= Вход @@ -352,22 +352,22 @@ Buffalo Buffalo Buffalo Използвайки 32-битовите offset basis (2166136261) и FNV простото число (16777619), изкарайте хешираната стойност на подадения ред текст. .note -*[(14.12.2025)]* Поправен хеш на последния пример. +[*(14.12.2025)*] Поправен хеш на последния пример. :table_2 |= Вход |= Изход -|: `[Hello World]` +|: [`Hello World`] |: 310551791 -|: `[Nothing]` +|: [`Nothing`] |: 383317984 -|: `[!]` +|: [`!`] |: 84696382 -|: `[The most effective debugging tool is still careful thought, coupled with judiciously placed print statements.]` +|: [`The most effective debugging tool is still careful thought, coupled with judiciously placed print statements.`] |: 2408366471 diff --git a/src/teaching/upp-2025/week12/index.du b/src/teaching/upp-2025/week12/index.du index 1fd2428..5fc86b8 100644 --- a/src/teaching/upp-2025/week12/index.du +++ b/src/teaching/upp-2025/week12/index.du @@ -113,12 +113,12 @@ day. Трябва да разположите двете полета в колоните така, че разстоянието между полетата и разтоянията между всяко поле и краищата са еднакви. -С други думи, ако сме получили `[Hello]`, `[World]` и 25 колони, трябва да изкараме следния низ (където `[|]` обграждат всичките колони): +С други думи, ако сме получили [`Hello`], [`World`] и 25 колони, трябва да изкараме следния низ (където [`|`] обграждат всичките колони): ``` | Hello World | -Разстоянието между `[|]` и `[H]` е същото като между `[o]` и `[W]`, и между `[d]` и `[|]`, а иммено 5 шпации. +Разстоянието между [`|`] и [`H`] е същото като между [`o`] и [`W`], и между [`d`] и [`|`], а иммено 5 шпации. Когато разстоянията не могат да са точни, трябва или средното да е по-късото, или и двата края да са по-къси. Ако буквите в думите са повече от броя колоните, тогава изкарайте думите слепени. @@ -166,12 +166,12 @@ Lorem ipsum Трябва да върнете типа на полето, спрямо тези правила: .ordered -1. =[Тип "integer":]= може да започне с `[+]` или `[-]` и всички останали букви са цифри -2. =[Тип "float":]= може да започне с `[+]` или `[-]` и след това съдържа цифри и точка, която точка трябва да се намира между цифри (т.е. не е преди или след всички цифри) -3. =[Тип "word":]= ако съдържа само латински букви (главни или малки) -4. =[Тип "time":]= може да започне или завърши с "AM" или "PM", след това (допускайки че е започва с низа) съдържа 1-2 цифри (часа), които са между 0 и 24 вкл., знака двоеточие `[:]` и накрая завършва на две цифри (минутите), които са между 0 и 59 вкл. -5. =[Тип "percentage":]= започва с поне една цифра, като след първите цифри може да има точка и още цифри, и накрая завършва на знака `[%]` -6. =[Тип "other"]=, когато не можем да го свържем с никое от горните правила +1. [=Тип "integer":=] може да започне с [`+`] или [`-`] и всички останали букви са цифри +2. [=Тип "float":=] може да започне с [`+`] или [`-`] и след това съдържа цифри и точка, която точка трябва да се намира между цифри (т.е. не е преди или след всички цифри) +3. [=Тип "word":=] ако съдържа само латински букви (главни или малки) +4. [=Тип "time":=] може да започне или завърши с "AM" или "PM", след това (допускайки че е започва с низа) съдържа 1-2 цифри (часа), които са между 0 и 24 вкл., знака двоеточие [`:`] и накрая завършва на две цифри (минутите), които са между 0 и 59 вкл. +5. [=Тип "percentage":=] започва с поне една цифра, като след първите цифри може да има точка и още цифри, и накрая завършва на знака [`%`] +6. [=Тип "other"=], когато не можем да го свържем с никое от горните правила :table_2 |= Вход @@ -324,17 +324,17 @@ Mo Tu We Th Fr Sa Su Обсега за един ред е една от 3 типа стойности: .numbered 1. цяло число (последователност от цифри), която определя реда в текущия текст -2. `[.]`, което обозначава текущия ред -3. `[$]`, което обозначава последния ред във файла +2. [`.`], което обозначава текущия ред +3. [`$`], което обозначава последния ред във файла -Ако въведем =[само]= обсег за един ред, то това обновява текущия ред. +Ако въведем [=само=] обсег за един ред, то това обновява текущия ред. -Имаме и обсег за няколко реда, който е във формата `[начало,край]`. -`[начало]` и `[край]` са в същия формат като обсега за един ред. +Имаме и обсег за няколко реда, който е във формата [`начало,край`]. +[`начало`] и [`край`] са в същия формат като обсега за един ред. Тоест, това са два обсега за един ред, слепени със запетая. -`[начало]` може да бъде пропуснато, в който случай по подразбиране е 1 (първия ред). -`[край]` може да бъде пропуснато, в който случай по подразбиране е `[$]` (последния ред). +[`начало`] може да бъде пропуснато, в който случай по подразбиране е 1 (първия ред). +[`край`] може да бъде пропуснато, в който случай по подразбиране е [`$`] (последния ред). Трябва да върнете съобщение за грешка, ако е подаден невалиден обсег за текущия текст. @@ -344,19 +344,19 @@ Mo Tu We Th Fr Sa Su Това са всички команди: .numbered -1. `[p]` - изкарва редовете в обсега -2. `[n]` - изкарва редовете в обсега, като преди всеки е поставен неговия номер на реда -3. `[d]` - изтрива редовете в обсега -4. `[а]` - добавя текст =[след]= всеки ред в обсега -5. `[i]` - добавя текст =[преди]= всеки ред в обсега -6. `[q]` - прекратява програмата - -Буквите, след командите `[a]` и `[i]` са текста, който трябва да бъде вмъкнат. +1. [`p`] - изкарва редовете в обсега +2. [`n`] - изкарва редовете в обсега, като преди всеки е поставен неговия номер на реда +3. [`d`] - изтрива редовете в обсега +4. [`а`] - добавя текст [=след=] всеки ред в обсега +5. [`i`] - добавя текст [=преди=] всеки ред в обсега +6. [`q`] - прекратява програмата + +Буквите, след командите [`a`] и [`i`] са текста, който трябва да бъде вмъкнат. Може да се вмъкне само по един ред текст. -След въвеждане на ред чрез `[a]` или `[i]`, текущия ред автоматично се обновява на ново-добавения ред. +След въвеждане на ред чрез [`a`] или [`i`], текущия ред автоматично се обновява на ново-добавения ред. -След изтриване на ред чрез `[d]`, трябва да обновите текущия ред, само когато има смисъл. +След изтриване на ред чрез [`d`], трябва да обновите текущия ред, само когато има смисъл. Например, ако текущия ред е 10 и изтриете ред 20, няма нужда от промяна. Ако текущия ред е 10 и изтриете редове 2 и 3, тогава текущия ред трябва да се намали с броя изтрите редове, а имменно, с 2, от 10 на 8. @@ -365,7 +365,7 @@ Mo Tu We Th Fr Sa Su Вход и изход не са смесени. Наклонения текст е допълнителен коментар на това, което се случва (тоест, вие не трябва да го подавате на вашата програма). -=[Вход 1:]= +[=Вход 1:=] ``` aThe man looked along the way he had come. aThe Yukon lay a mile wide and hidden under three feet of ice. @@ -373,7 +373,7 @@ aOn top of this ice were as many feet of snow. It was all pure white. ,p q -=[Изход 1:]= +[=Изход 1:=] ``` The man looked along the way he had come. The Yukon lay a mile wide and hidden under three feet of ice. @@ -381,7 +381,7 @@ On top of this ice were as many feet of snow. It was all pure white. [$br1] -=[Вход 2:]= +[=Вход 2:=] ``` aThe Yukon lay a mile wide and hidden under three feet of ice. iThe man looked along the way he had come. @@ -394,23 +394,23 @@ p ,p q -=[Изход 2:]= +[=Изход 2:=] ``` -*[Изход от ",2n"]* +[*Изход от ",2n"*] 1 The man looked along the way he had come. 2 The Yukon lay a mile wide and hidden under three feet of ice. -*[Изход от първото "p"]* +[*Изход от първото "p"*] On top of this ice were as many feet of snow. It was all pure white. -*[Изход от второто "p"]* +[*Изход от второто "p"*] The Yukon lay a mile wide and hidden under three feet of ice. -*[Изход от ",p"]*\n +[*Изход от ",p"*]\n The man looked along the way he had come.\n The Yukon lay a mile wide and hidden under three feet of ice.\n On top of this ice were as many feet of snow. It was all pure white. [$br1] -=[Вход 3:]= +[=Вход 3:=] ``` aNorth and south, as far as his eye could see, ait was unbroken white. @@ -429,29 +429,29 @@ icurved from the pine-covered ,p q -=[Изход 3:]= +[=Изход 3:=] .note -=[(23.12.2025)]= Поправен този изход +[=(23.12.2025)=] Поправен този изход ``` -*[Изход от "3,5p"]* +[*Изход от "3,5p"*] The one thing that relieved the whiteness was a thin dark line that cruved from the pine-covered -*[Изход от ",n"]* +[*Изход от ",n"*] 1 North and south, as far as his eye could see, 2 it was unbroken white. 3 The one thing that relieved 4 the whiteness was a thin dark line that 5 island to the south. -*[Изход от ".,$p"]* +[*Изход от ".,$p"*] curved from the pine-covered the whiteness was a thin dark line that island to the south. -*[Изход от ".n"]* +[*Изход от ".n"*] 3 curved from the pine-covered -*[Изход от ",p"]* +[*Изход от ",p"*] The one thing that relieved the whiteness was a thin dark line that curved from the pine-covered -- cgit v1.3.1-26-gb76a