The Publishing Project

Creating a technology glossary

As part of creating a writing guide for my content, I’ve been thinking about how to create a glossary of technical terms that we can expand as we go along. Yahoo! Style Guide provided such a glossary and made it available for download so people could use it as is or use it as a starting point for their own glossaries. The project tries to create a glossary of relevant terms for a technology blog. Some steps leading to this are: Convert the Yahoo Style Guide to JSON to use as the base for the glossary Decide if this is

Import maps: What they are and why they are important

Most current browsers support ESModules. This is the way the ECMAScript standard defines import modules. However, because it’s come late to the party after UMD and CommonJS modules, they are not widely used on client-side code. One of the problems is how to reference the modules we want to import. Import maps are a way to map the names of imported packages to the full path on the filesystem allowing developers to use bare module import. At their simplest, import maps are a list of tuples in the form of <package-name>: <path-to-package> The following example gives Lodash the identified Lodash,

Github Actions for Process Automation

A lot of times we need to build a project every time we make changes. I picked my Gulp publishing process to test if Github actions work with this. The idea is that every time we push a commit or we close a Pull Request, Github Actions will run the Gulp default build process from the content in the main branch. See the Github Actions Documentation for more information about the tool, how it works and what you can do with it. The First Try In the first pass, we want to validate that the project is set up correctly

Annotating a WordPress site with Hypothesis

I’ve always been interested in web annotations as a means to increase interaction between users and content and between users. Over the time I’ve been researching the annotation landscape I’ve found that Hypothesis is my favorite. It also has a WordPress plugin that integrates personal Hypothesis accounts with whatever sites they visit, not just my WordPress site. This post will discuss web annotations, how they are, and how they work. It will also discuss how to incorporate Hypothesis into a WordPress site using a plugin. What are web annotations? Annotations are an additional layer of information attached to a web

CSS Modules and Constructable Stylesheets

If you work with web components, one of the pain points is how to add styles to multiple copies of the same component. None of the existing solutions work well and all have one or more rough edges. See the CSS Modules Scripts Chrome Status Entry for an explanation of the rough edges as seen by the team implementing the feature. CSS Module Scripts (CSS Modules for short) allows you to import an external stylesheet and attach it to multiple documents and components. import sheet from ‘./index.css’ assert { type: ‘css’ }; document.adoptedStyleSheets = […document.adoptedStyleSheets, sheet]; // Attach to a