Compare commits
1 Commits
Author | SHA1 | Date | |
---|---|---|---|
f41d77c93a |
16
README.md
16
README.md
@ -1,19 +1,3 @@
|
||||
# davesmithhayes.com
|
||||
|
||||
This repository holds the code that deploys into the blog for Dave Smith-Hayes.
|
||||
|
||||
## TODO
|
||||
|
||||
This is an unorganized list of the features left for the blog.
|
||||
|
||||
* Pages Handler
|
||||
* Renders Markdown pages into HTML pages
|
||||
* Dynamic Navigation
|
||||
* Blog Roll
|
||||
* List of blogs I have read and liked
|
||||
* External Links
|
||||
* Links to my git, music, other things
|
||||
* RSS Feed
|
||||
* robots.txt
|
||||
* Site map
|
||||
* Images on posts and pages
|
||||
|
@ -1,8 +1,6 @@
|
||||
---
|
||||
title: Thoughts on JavaScript
|
||||
description: |>
|
||||
Describing the architecture of Handlers, Services, (Domains), and
|
||||
Presentation
|
||||
description: Describing the architecture of Handlers, Services, (Domains), and Presentation
|
||||
date: 2024-08-11
|
||||
tags:
|
||||
- development
|
||||
@ -14,35 +12,16 @@ draft: true
|
||||
|
||||
## My History With JavaScript
|
||||
|
||||
I think the first time I wrote JavaScript and got paid for it, I was young,
|
||||
dumb, and willing to work at a design agency for nearly minimum wage making
|
||||
WordPress templates and CakePHP applications. The team I worked with had
|
||||
adopted jQuery for all things front-end - _which was the style at the time_. I
|
||||
think this time was about 2014.
|
||||
I think the first time I wrote JavaScript and got paid for it, I was young, dumb, and willing to work at a design agency for nearly minimum wage making WordPress templates and CakePHP applications. The team I worked with had adopted jQuery for all things front-end - which was the style at the time. I think this time was about 2014.
|
||||
|
||||
From there, I moved on to other agency jobs and finally ended up at my current
|
||||
place of employment as a lowly _PHP Developer_. This role was designed to
|
||||
solely work on a single Magento 1 codebase. Again, jQuery was the tool of
|
||||
choice. Of course the JavaScript landscape was changing rapidly with the
|
||||
introductions of Node.js, and frameworks like Angular and React. I paid no
|
||||
mind to these since the bulk of my work was still in the world of Magento 1
|
||||
and working on a plan to migrate to Magento 2.
|
||||
From there, I moved on to other Agency jobs and finally ended up at my current place of employment as a lowly _PHP Developer_. This role was designed to solely work on a single Magento 1 codebase. Again, jQuery was the tool of choice. Of course the JavaScript landscape was changing rapidly with the introductions of Node.js, and frameworks like Angular and React. I paid no mind to these since the bulk of my work was still in the world of Magento 1 and working on a plan to migrate to Magento 2.
|
||||
|
||||
It wouldn't be until 2018 (or maybe 2019?) that I would write a line of
|
||||
JavaScript for Node.js. We had decided to go all-in on AWS Lambda. I worked on
|
||||
a service that would push order data out of our Magento instance into our
|
||||
Production Facility's database. Let's call this _The Bridge_. This Lambda was
|
||||
invoked by API Gateway. This was a very small web service, essentially. This
|
||||
was, also, my first experience with _Callback Hell_. There was no `await` and
|
||||
no real `Promise` API (except, _I think_ Bluebird, but I never knew about it
|
||||
at the time) yet. The service actually needed to do a lot of queries, and use
|
||||
those results for other queries, so on, and so forth. If you're familiar with
|
||||
working on Callback Hell you will recognize this:
|
||||
It wouldn't be until 2018 (or maybe 2019?) that I would write a line of JavaScript for Node.js. We had decided to go all-in on AWS Lambda. I worked on a service that would push order data out of our Magento instance into our Production Facility's database. Let's call this _The Bridge_. This Lambda was invoked by API Gateway. This was a very small web service, essentially. This was, also, my first experience with _Callback Hell_. There was no `await` and no real `Promise` API (except, _I think_ Bluebird, but I never knew about it at the time) yet. The service actually needed to do a lot of queries, and use those results for other queries, so on, and so forth. If you're familiar with working on Callback Hell you will recognize this:
|
||||
|
||||
```javascript
|
||||
var mysql = require("mysql");
|
||||
|
||||
var config = { ... };
|
||||
var config = {...};
|
||||
|
||||
mysql.connect(config, function (err, conn) {
|
||||
// handle the error
|
||||
@ -71,28 +50,15 @@ mysql.connect(config, function (err, conn) {
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
_This sucks._
|
||||
|
||||
We ended up rewriting this service in C# as that was the most popular language
|
||||
within the organization at the time. Honestly, thank god. I didn't need to
|
||||
write or maintain the service once it fell into the hands of the .NET team.
|
||||
We ended up rewriting this service in C# as that was the most popular language within the organization at the time. Honestly, thank god. I didn't need to write or maintain the service once it fell into the hands of the .NET team.
|
||||
|
||||
## How I Approached Big Applications
|
||||
|
||||
Eventually all the .NET guys left the company. My boss left the company. I was
|
||||
put in charge and the first thing I did was deploy an Express.js application to
|
||||
completely rewrite the service discussed above. I did this because this was
|
||||
actually faster to do than figure out how the build system (Jenkins, Ansible,
|
||||
and TeamCity _I think_) and deploy it to our common pattern architecture. It
|
||||
was also a way for me to prove to my new boss that I can get things done and
|
||||
that moving to slowly remove our reliance on .NET and IIS for our services was
|
||||
a worthy endeavor.
|
||||
Eventually all the .NET guys left the company. My boss left the company. I was put in charge and the first thing I did was deploy an Express.js application to completely rewrite the service discussed above. I did this because this was actually faster to do than figure out how the build system (Jenkins, Ansible, and TeamCity _I think_) and deploy it to our common pattern architecture. It was also a way for me to prove to my new boss that I can get things done and that moving to slowly remove our reliance on .NET and IIS for our services was a worthy endeavor.
|
||||
|
||||
A lot of my experience up until that point was mostly working in Magento 2,
|
||||
which is a massive, Enterprisey, PHP application. Modern PHP tends look more
|
||||
and more like C# or Java as the years go on. So that's where my mind is -
|
||||
poisoned by web MVC and Enterprise OOP (_tm_).
|
||||
A lot of my experience up until that point was mostly working in Magento 2, which is a massive, Enterprisey, PHP application. Modern PHP tends look more and more like C# or Java as the years go on. So that's where my mind is - poisoned by web MVC and Enterprise OOP (_tm_).
|
||||
|
||||
|
||||
|
||||
|
@ -27,7 +27,7 @@ callbacks to events that will be run when that particular event is emitted.
|
||||
import EventEmitter from "node:events";
|
||||
|
||||
const em = new EventEmitter();
|
||||
em.on("some-event", function () {
|
||||
em.on("home-event", function () {
|
||||
console.log("Something happened.");
|
||||
});
|
||||
|
||||
@ -65,14 +65,6 @@ class SomePool extends EventEmitter {
|
||||
public getFreeConnectionCount(): number {
|
||||
return this.freeConnections;
|
||||
}
|
||||
|
||||
public function getConnection() {
|
||||
this.emit("pre-connect");
|
||||
|
||||
if (this.freeConnections) {
|
||||
// get a connection
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
@ -80,37 +72,5 @@ So now, in any callback function* we can get the total number of free
|
||||
connections in the `SomePool` class.
|
||||
|
||||
```typescript
|
||||
const pool = new SomePool();
|
||||
pool.on("pre-connect", function () {
|
||||
if (this.freeConnections) {
|
||||
this.freeConnection = this.freeConnection - 1;
|
||||
}
|
||||
});
|
||||
title=
|
||||
```
|
||||
|
||||
This is a really impractical use of `EventEmitter`, but I think it does a good
|
||||
job at illustrating the scope of the callback function on the `on` method and
|
||||
how it can alter the state of the `SomePool` class. There is definitely a case
|
||||
for when this can be super helpful and useful.
|
||||
|
||||
## The Arrow Function
|
||||
|
||||
One of the big things in JavaScript is to use this nifty little short-hand to
|
||||
create a function:
|
||||
|
||||
```typescript
|
||||
[1, 2, 3].map((i) => i + 1);
|
||||
```
|
||||
|
||||
This is super useful to keeping code clean and concise - but there is a huge
|
||||
caveat using the arrow function over the classic function definition. When you
|
||||
do an arrow function, you are not inheriting the scope of the object you are
|
||||
attaching the callback to.
|
||||
|
||||
So in the example above, the object is the Array object, implicitly
|
||||
instantiated, and having its method `map` called (which iterates over each of
|
||||
the items in an Array, and does something, in this case, adding 1 to it).
|
||||
|
||||
|
||||
|
||||
|
||||
|
@ -1,96 +0,0 @@
|
||||
---
|
||||
title: The Absolute Basics on Web Development
|
||||
description: A post en which I talk about the basics of web development.
|
||||
date: 2024-11-18
|
||||
tags:
|
||||
- development
|
||||
- html
|
||||
- css
|
||||
- javascript
|
||||
slug: the-basics-of-web-development
|
||||
draft: true
|
||||
---
|
||||
|
||||
## The Server & Client
|
||||
|
||||
At the time of this posting, I have already conducted a workshop at a Hackathon
|
||||
for High School students in my city. My workshop took the kids from nothing to
|
||||
a very basic HTML document published on to the internet. I ended up using
|
||||
Github Codespaces, and Github Pages to get them from 0 to Web Page with the
|
||||
least amount of friction. Those technologies aside, this whole endeaver
|
||||
inspired me to write down what I think are the absolute basics, as I understand
|
||||
them from my own experience as a professional web developer.
|
||||
|
||||
The first thing to truly understand is the relationsihp between a Server and
|
||||
the Client. The Server is a piece of software that reacts to requests from a
|
||||
Client. The Client is you - probably using a web browser like Firefox or
|
||||
Chrome.
|
||||
|
||||
I think its important to talk about TCP/IP, the packet, and the structure of
|
||||
the Request and Response data.
|
||||
|
||||
## The Document
|
||||
|
||||
The best way to conceptualize what a web page is, is to look at what it
|
||||
actually is - a document. The Document is made up of a special Markup language
|
||||
called Hyper Text Markup Language (HTML). This is a form of Hypermedia - a
|
||||
concept we don't have to fully invest in yet.
|
||||
|
||||
HTML describes structure and classification of data. There are three main
|
||||
parts of an HTML document:
|
||||
|
||||
1. The Document Type
|
||||
2. The Header
|
||||
3. The Body
|
||||
|
||||
The Document Type simply states "Hey, this document is of this format." We wont
|
||||
go into the history of the HTML Document Type tag since once HTML was
|
||||
standardized we perfected the notion of how to declare a document type.
|
||||
|
||||
If you're curious about the history of this line and what it used to look like,
|
||||
feel free to look at [the Wikipedia article on the subject](https://en.wikipedia.org/wiki/Document_type_declaration).
|
||||
|
||||
The Header is _meta data about the document_. This is where things like the
|
||||
Title of the document is declared, where character set in the document is
|
||||
defined, and other things like injecting remote files like stylesheets and
|
||||
JavaScript.
|
||||
|
||||
The Body is where the content for the document actually lives. This is where we
|
||||
will write a majority of our HTML and present the information we want to share
|
||||
with the world.
|
||||
|
||||
Let's take a look at the document we are going to craft. By the end of this
|
||||
blog, if you wish to follow along, you will have a very basic understanding of
|
||||
how the web works.
|
||||
|
||||
```html
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<title>A simple web page.</title>
|
||||
</head>
|
||||
<body>
|
||||
<!-- This is a comment, this is not rendered to the page. -->
|
||||
<h1>Level 1 Header</h1>
|
||||
<p>This is a paragraph that will live on the page.</p>
|
||||
<p>This paragraph has a <a href="https://tildes.net">Link to Tildes</a> on it!</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
## The Stylesheet
|
||||
|
||||
Styling HTML is usually done through a language called Cascading Style Sheets.
|
||||
This language allows you to define things like font families, sizes, colours,
|
||||
and even placement on the document itself. CSS has gone through a huge
|
||||
evolution since I first learned it in 2004(ish). While I am no designer (that's
|
||||
my wife), I have learned some really basic skills over the years that allow me
|
||||
to get a basic, legible, site styled. Case and point: this blog.
|
||||
|
||||
## Interactivity
|
||||
|
||||
The only real way to add interactivity to an HTML document these days is to add
|
||||
some JavaScript. JavaScript is a temultuous topic in and of itself but I think
|
||||
understanding the basics, especially within the context of a Web Browser and
|
||||
on an HTML document, can help you appreciate what a little of client-side code
|
||||
can do to improve the experience of reading some documents.
|
16
src/handlers/about.tsx
Normal file
16
src/handlers/about.tsx
Normal file
@ -0,0 +1,16 @@
|
||||
import { Hono, Context } from 'hono';
|
||||
|
||||
const aboutPage = new Hono();
|
||||
|
||||
export async handleAboutPage(c: Context) {
|
||||
const meta: SiteMeta = {
|
||||
title: "About",
|
||||
description: "About Dave Smith-Hayes - a dad, developer, musician.",
|
||||
author: "Dave Smith-Hayes"
|
||||
};
|
||||
|
||||
c.render(<AboutPage />, { meta });
|
||||
}
|
||||
|
||||
aboutPage.get("/about", handleAboutPage);
|
||||
export default aboutPage;
|
@ -1,6 +1,7 @@
|
||||
import { Style } from 'hono/css';
|
||||
import { SiteMeta } from '@blog/models/SiteMeta';
|
||||
import { MetaTags } from '@blog/templates/components/MetaTags';
|
||||
import { Navigation } from '@blog/templates/componennts/Navigation';
|
||||
|
||||
function getPageTitle(title: string|undefined): string {
|
||||
if (!title) {
|
||||
@ -25,6 +26,9 @@ export function Page({ children, meta }: { children: any, meta: SiteMeta }) {
|
||||
<a href="/">davesmithhayes.com</a>
|
||||
</div>
|
||||
</header>
|
||||
<nav>
|
||||
<Navigation />
|
||||
</nav>
|
||||
<main>
|
||||
{children}
|
||||
</main>
|
||||
|
7
src/templates/Pages/AboutPage.tsx
Normal file
7
src/templates/Pages/AboutPage.tsx
Normal file
@ -0,0 +1,7 @@
|
||||
export function AboutPage() {
|
||||
return (
|
||||
<div class="main">
|
||||
<p>Hello! I am Dave Smith-Hayes.</p>
|
||||
</div>
|
||||
);
|
||||
}
|
12
src/templates/components/Navigation.tsx
Normal file
12
src/templates/components/Navigation.tsx
Normal file
@ -0,0 +1,12 @@
|
||||
const pages: Array<{ path: string, title: string }> = [
|
||||
{ path: "/", title: "Home" },
|
||||
{ path: "/about", title: "About" },
|
||||
];
|
||||
|
||||
export function Navigation() {
|
||||
return (
|
||||
<ul>
|
||||
{pages.map(p => <li><a href={p.path}>{p.title}</a></li> )}
|
||||
</ul>
|
||||
);
|
||||
}
|
Loading…
Reference in New Issue
Block a user