1. State of the art, project management and documentation¶
This week, we discussed the main Fabricacademy subjects, vision, objective, and overall expectations for documenting our research. We talked about why documentation is so important to the program, and displaying our results, explaining our design process, what we’re thinking, and including our mistakes, and accomplishments.
Nadia Attmore-Cover Art
Research & Ideation¶
My primary goal for week 1 was to create my Fabricacademy website, a digital portfolio for my work that helps to express who I am as an artist, designer, and a storyteller.
Coding was completely unknown to me. I’d never used a coding editor before, yet alone written HTML or CSS.
At first, everything seemed totally overwhelming, having to understand a new “language” such as commands, tags, and syntax, pushing uploads and committing changes to my page, and most importantly a new style of thinking with logic first rather than a visual approach.
References & Inspiration¶
I looked for websites that matched my personal aesthetic.
Harlem Fashion Row gave me the editorial, polished, and strong visual storytelling I was also looking to achieve. Nike gave me the modern and tech forward approach that I also wanted to include.
These websites inspired me to create a digital platform that is strong, purposeful and thoughtfully designed, just like my physical work.
Tools¶
- Markdown
- Google
- Bracket
- W3Schools
- MKdocs
- YouTube
Documentation workflow¶
The quickest thing I noticed was that the “language” wasn't so straightforward, because every change required perfection, one missing bracket or extra slash could break an entire section of the site.
There were days when the whole page would fail and zero of my commits would change on my site. Images wouldn't load. Or the text overlapped or went into another section I didn't want it in. These continued errors lead me straight to the internet finding any tools possible to help me gain an understanding.
Step 1¶
Install MkDocs
You need Python installed.
pip install mkdocs To install your theme (usually "Material"):
pip install mkdocs-material
Understanding Markdown (The language)
Markdown = simple text that converts to formatted webpages.
Basic Markdown Tools- Headers:
1 (#) # Title 2(#) ## Subtitle 3(#) ### Section
Images:
![alt text] (path/to/image.jpg)
Live Preview:
Allows you to preview your site while editing.
Publishing (Deploying/Committ)
When you’re ready to publish:
mkdocs gh-deploy
This pushes your site to GitHub Pages.
Step 2¶
Editing the index.html file
site_name: NADAE by Nadia Attmore
site_description: Your name Fabricademy site
site_author: NADAE by Nadia Attmore
copyright: Copyright 2024 NADAE by Nadia Attmore - Creactive Commons Attribution Non-commercial
site_url: https://class.textile-academy.org/2026/nadia-attmore/
repo_url: https://gitlab.fabcloud.org/academany/fabricademy/2026/students/nadia-attmore
repo_name: fabricademy/2026/nadia-attmore
Step 3¶
Experimenting with fonts, colors, and how I wanted the layout of my page.
theme:
# The name of the theme, needs to match your requirements.txt file
name: material
# Material theme options:
palette:
# try other colors from https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/
primary: black
accent: red
font:
# See available fonts from https://fonts.google.com/
text: Bodoni Moda
code: Bodoni Moda
icon:
# Read about icons at https://squidfunk.github.io/mkdocs-material/setup/changing-the-logo-and-icons/
logo: material/library
repo: material/gitlab
features:
- navigation.tabs
- navigation.footer
...
Although this week seemed like nothing but chaos, confusion and frustration it made me realize that this was a form of logical design. I’m so used to expressing myself through textiles, patterns, prints, and movements. I know I still have a lot to learn and know the errors aren't stopping after this week but I am hopeful in the future that by the end of this I will be a technology wiz.