From 09409c5e39c79a251b59b5cb19c0123b4705699c Mon Sep 17 00:00:00 2001 From: Syndamia Date: Thu, 24 Sep 2020 11:47:00 +0300 Subject: Improved wording of syndamiadotcom project articles --- src/projects/syndamiadotcom/introduction.md | 6 +++--- src/projects/syndamiadotcom/version1.md | 32 +++++++++++++++-------------- src/projects/syndamiadotcom/version2.md | 15 +++++++------- 3 files changed, 28 insertions(+), 25 deletions(-) (limited to 'src/projects') diff --git a/src/projects/syndamiadotcom/introduction.md b/src/projects/syndamiadotcom/introduction.md index 29c255d..6b2bcf6 100644 --- a/src/projects/syndamiadotcom/introduction.md +++ b/src/projects/syndamiadotcom/introduction.md @@ -1,14 +1,14 @@ # syndamiadotcom - Introduction -**Article Created: 01 August 2020** || **Last Edited: 10 September 2020** +**Article Created: 01 August 2020** || **Last Edited: 24 September 2020** [`Version 1 >`](./version1.html) --- -This very website is a big project in itself. I started it on **25 May** as a place to explain my project [Mundus](/projects/mundus/introduction.html) in detail. Over time I've made it into a place for not only my **projets** but also for **tutorials**, **blog posts** and **portfolio**. +One of my biggest networking and front-end projects is this very website. I started it on **25 May** as a place to talk about my project [Mundus](/projects/mundus/introduction.html). Over time it has become a **hub** for my **projects**, **tutorials**, **blog** and even **portfolio**. -Website versions differ mosty by **styling** and **system for managing content**. +**Note**: Website versions differ mostly by **styling** and **system for managing content**. ## Contents diff --git a/src/projects/syndamiadotcom/version1.md b/src/projects/syndamiadotcom/version1.md index 79d056d..5058f33 100644 --- a/src/projects/syndamiadotcom/version1.md +++ b/src/projects/syndamiadotcom/version1.md @@ -1,6 +1,6 @@ # syndamiadotcom - Version 1 -**Article Created: 01 August 2020** || **Last Edited: 10 September 2020** +**Article Created: 01 August 2020** || **Last Edited: 24 September 2020** [`< Introductoin`](./introduction.html) || [`Version 2 >`](./version2.html) @@ -8,19 +8,21 @@ ![](./img/welcome-v1.png) -[Version 1](https://github.com/Syndamia/syndamiadotcom/releases/tag/v1.0) is the **very first design** this website had and probably the **ugliest** one it will ever have. It has a tabbed layout with dark-themed colors. I used no system for managing content, meaning **I wrote each and every line of `HTML` by hand**. +[Version 1](https://github.com/Syndamia/syndamiadotcom/releases/tag/v1.0) is the **very first design** of this website. It's probably also the ugliest. + +It uses a tabbed layout with dark-themed colors. At the time, I didn't use any form of a content management system, meaning **I wrote each and every line of `HTML` by hand**. [Version 1](https://github.com/Syndamia/syndamiadotcom/releases/tag/v1.0) was used in production for close to **2 months**, from **25 May 2020** to **21 July 2020**. -This was the **first serious website** I have ever done so I had some extremely basic front-end skills and practically no knowledge for good web design. +This was the **first serious website** I have ever done, so, at the time, I had only some extremely basic front-end skills and practically no knowledge for good web design. ## Layout and navigation -I based it on [xed](https://github.com/linuxmint/xed) (dark theme), a lightweight text editor. +I based it on the text editor I was using at the time: [xed](https://github.com/linuxmint/xed) (Oblivion theme). ![](./img/xed-overview.png) -The whole idea was that navigation through multiple pages would be done mostly through **tabs**. +My vision was that I was going to use a similar **tab** style navigation between pages. Navigating between the main pages (*Home*, *About*, *Projects*, etc.) is also done through tabs. @@ -32,11 +34,11 @@ Navigating between the main pages (*Home*, *About*, *Projects*, etc.) is also do *Newest version* -Pages for *tutorials* and *projects* had two differences with the main pages: to the left of the tabs there is the title of the *tutorial/project* +Articles for *tutorials* and *projects* had two differences with the main pages: to the left of the tabs there is the title of the *tutorial/project* ![](./img/multi-title.png) -and to the right we have a back button, with which you would get back to the main pages. +and to the right there is the back button, with which you could get back to the main pages. ![](./img/multi-back-btn.png) @@ -46,13 +48,13 @@ and to the right we have a back button, with which you would get back to the mai ## Style overview -The colors are also based on [xed](https://github.com/linuxmint/xed)). +The colors are also based on [xed](https://github.com/linuxmint/xed). -Pages are the place where the content is shown. They use a special backgound (![](./img/70-70-70.png) `#707070` ), **different from the body background** color (![](./img/47-47-47.png) `#474747`) on white foreground. +Pages are the place where the content is shown. They use a special background (![](./img/70-70-70.png) `#707070` ), **different from the body background** color (![](./img/47-47-47.png) `#474747`) on white foreground. ![](./img/sample-page-v1.png) -Hyperlinks have the ![](./img/d6-d6-d6.png) `#d6d6d6` color, which is a bit **hard to see** on the page background and pretty difficult to differentiate from normal text. +Hyperlinks have the ![](./img/d6-d6-d6.png) `#d6d6d6` color, which is pretty **hard to see**. ![](./img/sample-hyperlink-v1.png) @@ -66,7 +68,7 @@ Separators have the ![](./img/dd-dd-dd.png) `#dddddd` color with no shadow. ![](./img/separator-v1.png) -Tables have **hidden borders** with centered text in them. At the time this website version was in production, the only place tables you could find were in the *Tutorials*, *Projects* and *Resume* pages, where certain rows that needed borders had a **row with a separator** between them. +Tables have **hidden borders** with centered text in them. At the time, the only place you could find tables were in the *Tutorials*, *Projects* and *Resume* pages, where certain rows that needed borders had a **row with a separator** between them. ![](./img/table-v1.png) @@ -74,17 +76,17 @@ Tables have **hidden borders** with centered text in them. At the time this webs This version **didn't use any content management** of any shape or form. All pages were written in HTML **manually**. -Later in it's lifespan the **header** and **footer** were made to be **generated through (stupidly written) `JavaScript`**. +Later in it's lifespan the **header** and **footer** were made to be **generated through (bad) `JavaScript` code**. ## Why was it replaced? This version was discontinued for three main reasons: -- **First**, adding new pages was very laborious, having to **rewrite the `HTML`** code for **each new page** from scratch manually. +- **First**, having to **write the `HTML`** code for **each new page** from scratch manually was very laborious -- **Second**, **it was ugly**. I came up and made most of the initial design in 2-3 days and kind of left it as it was, I didn't work in it thoroughly. +- **Second**, **it was ugly**, the design was rushed and poorly implemented -- **Third**, it just **doesn't work**. I mean, if you are on a 1080p computer monitor it was fine, but if you are on anything a bit smaller, it starts to kind of break. +- **Third**, it just **doesn't work**. I mean, if you are on a 1080p computer monitor it was fine, but if you are on anything a bit smaller, it starts to kind of break ![](./img/iphonex-v1.png) diff --git a/src/projects/syndamiadotcom/version2.md b/src/projects/syndamiadotcom/version2.md index a2e3778..38e04b4 100644 --- a/src/projects/syndamiadotcom/version2.md +++ b/src/projects/syndamiadotcom/version2.md @@ -1,6 +1,6 @@ # syndamiadotcom - Version 2 -**Article Created: 02 August 2020** || **Last Edited: 10 September 2020** +**Article Created: 02 August 2020** || **Last Edited: 24 September 2020** [`<<`](./introduction.html) || [`< Version 1`](./version1.html) @@ -8,19 +8,19 @@ ![](./img/welcome-v2.png) -[Version 2](https://github.com/Syndamia/syndamiadotcom/releases/tag/v2.0) is mostly based on a `Markdown` layout. Pages are written in `Markdown` and made into the final `HTML` files through [ssg](https://www.romanzolotarev.com/ssg.html) and [lowdown](https://kristaps.bsd.lv/lowdown/). +[Version 2](https://github.com/Syndamia/syndamiadotcom/releases/tag/v2.0) is mostly based on a `Markdown` style. Pages are written in `Markdown` and made into the final `HTML` files through [ssg](https://www.romanzolotarev.com/ssg.html) and [lowdown](https://kristaps.bsd.lv/lowdown/). [Version 2](https://github.com/Syndamia/syndamiadotcom/releases/tag/v2.0) has been used in production ever since **21 July 2020**. -My insparation and guide was an excellent video from [Wolfgang](https://www.youtube.com/channel/UCsnGwSIHyoYN0kiINAGUKxg) on making a [fast and minimal blog](https://www.youtube.com/watch?v=N_ttw2Dihn8). +My inspiration and guide was an excellent video from [Wolfgang](https://www.youtube.com/channel/UCsnGwSIHyoYN0kiINAGUKxg) on making a [fast and minimal blog](https://www.youtube.com/watch?v=N_ttw2Dihn8). ## Layout and navigation -This version uses a more **traditional layout**, compared to the previous one. In the header there are **universal links** to the main pages (*Home*, *About*, *Projects*, etc.) +This version uses a more **traditional layout** (although similar to the previous one). In the header there are **universal links** to the main pages (*Home*, *About*, *Projects*, etc.) ![](./img/header-v2.png) -All *project/tutorials* have an introduction page which contains contents of *project/tutorial* (links to all of the pages). +All *project/tutorials* have an introduction page which contains contents of the *project/tutorial* (links to all of the pages). ![](./img/introduction-v2.png) @@ -60,6 +60,7 @@ Code blocks, inline code, blockquotes and tables are taken from [sindresorhus's ## Content management -This version still **doesn't** use a **content management system**, although managing content is considerably simpler. +This version **doesn't** use a full-fledged **content management system**, but managing is a lot more automated. + +Pages are written in `Markdown` formatting and making the website is done with `ssg`, that takes care of generating the webpages, sitemap, etc. and `lowdown`, that converts the `Markdown` to `HTML`. -I write the pages in `Markdown` files and `ssg` and `lowdown` take care of **everything else** (the header and footer are in separate `HTML` files). -- cgit v1.3.1-26-gb76a