Editing the site — Brickfolio HTML
Every page of Brickfolio’s HTML edition is a plain file you edit in a code editor: where everything is, and how to change Home’s sections, add a project or a post, or add a page.
Open it
Section titled “Open it”Double-click index.html: the site opens in your browser and every link between pages works, straight from the
folder. To see it exactly as a host serves it (and to test the forms and the 404 page), run a small local server from
the folder:
npx serve .npm start runs the same command. Then edit the files in a code editor and reload the browser to see the change.
What is where
Section titled “What is where”index.html Home: the profile card, every section, the footerproject/*.html one page per project (6)blog/*.html one page per post (12)404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)cv.pdf the CV behind "Download CV"assets/css/style.css the stylesheet (generated — see design.md)assets/js/main.js the site's scripts (you rarely need to touch it)assets/js/config.js your settings: form endpointassets/images/ photos and client logosassets/icons/ the social networks' marks shown over a hovered social linkassets/fonts/ Inter, Fragment Monoicon.png, apple-icon.pngsitemap.xml, robots.txtsrc/css/style.css the stylesheet's source: colours, breakpoints, fontsPages describes every page, section by section.
Find the words on the page and change them in the HTML. Keep the tags and classes around them, because they carry the layout. A project card’s title looks like this:
<h3 class="text-sm leading-[1.2] font-medium md:text-base lg:text-lg text-light"> EcoShop - Sustainable E-commerce Platform</h3>Change the words, leave the class. Long lines are wrapped onto several lines in the files, so when you search for a
sentence, search for a few words of it. Ampersands are written & (Latest Articles & Publications) and some
apostrophes ' (Let's Connect); the demo also uses the typographic ’ (I’m). Typing ' and " in text works
too; & should stay &.
Dates are written twice: <time datetime="2024-07-08">Jul 8, 2024</time>. The datetime is the date in
year-month-day form (a project’s is 2024-07, month only), for search engines; the text is what the visitor reads.
Text that repeats on every page
Section titled “Text that repeats on every page”The header, the footer and the newsletter box are copied into every page. Change them once for all files with your
editor’s Find in Files / Replace in Files (VS Code: Ctrl/Cmd + Shift + H):
| Replace | With |
|---|---|
https://brickfolio-html-framebrick.vercel.app |
Your domain, e.g. https://www.yourname.com (canonical links, share cards, sitemap.xml, robots.txt) |
>Brick< and >folio< |
The two lines of your name in the logo (Design) |
aria-label="Brickfolio" |
Your name: the name of the logo link, for screen readers |
Copyright © Brickfolio | Designed by Framebrick |
Your footer line (it is in the footer of every page, and in the profile card of index.html from 1440 px) |
| Brickfolio</title> and | Brickfolio" in share tags |
| Your Name (Home’s title, Brickfolio - Personal Portfolio Website, has no suffix) |
content="Brickfolio" |
Your site’s name (application-name and og:site_name) |
Subscribe to Our Newsletter, Join now and never miss out on our stuff again. Because you are worth it! |
The newsletter box’s title and text |
Hire Me |
The header’s button (it leads to the contact form) |
Include the .html, .xml and .txt files. Review each change before replacing all.
Blocks that repeat on several pages
Section titled “Blocks that repeat on several pages”| Block | Pages |
|---|---|
| Header, with the phone menu | Every page (the 404’s links start at the site’s root, /index.html#…) |
| Footer: the newsletter box and the copyright line | Every page but the 404 |
| A project’s card | “My Latest Work” on Home, and “More Projects” on the other project pages |
| A post’s card | “Latest Articles & Publications” on Home, and “More Posts” on the other posts of its category |
Search the folder for a project’s or a post’s file name (ecoshop-sustainable-e-commerce-platform) to find every card of
it.
Home, section by section
Section titled “Home, section by section”index.html holds every section of Home in order: the profile card, My Latest Work, Work with Me, “Can’t decide or custom
request?”, Trusted by Professionals, My Experiences, My Awesome Clients, Latest Articles & Publications, Let’s Connect
and Questions? Answers, then the footer. Each section’s title is written in two parts: the words and the accent word in
bold italic (My Latest <span class="font-bold italic">Work</span>).
- The profile card: the photo (
profile-javier-martinez.png), the greeting, the roles, the headline (the page’s<h1>), the text and the four social links (each a two-letter chip such asFB, the network’s name inaria-label, and its mark fromassets/icons/, shown on hover). - The roles under the greeting step up every four seconds. They are written three times: once in a line for screen
readers (
<span class="sr-only">Product Designer, Web Designer, …</span>), then one<li>per role, then the first role again as the last<li>(so the loop has no gap). The box carriesdata-count="4": the number of roles. Change all three when you change the roles. - The services: four cards, each with its title, description, “Starting at $3,000 per project”, “More Details” (to
#contact) and two columns of small photos. Each column lists the four photos twice (so the loop has no gap), the first column in order and the second in reverse: replace a photo in all four places, or keep the file name. - The testimonials and the client logos are tickers: the list is written twice, the second copy with
aria-hidden="true", and the box carriesdata-count(8 quotes, 5 logos) anddata-speed(pixels per second). When you add, remove or change a quote or a logo, do it in both copies and setdata-countto the new number. - “Download CV” links to
cv.pdf: replace that file with your CV. - The contact form and the newsletter box are described in Forms.
- The questions: each is a button and an answer; the first is open (
aria-expanded="true") and the others closed. Copy a closed one to add a question, and keep itsidandaria-controlspair unique.
Projects and posts on Home
Section titled “Projects and posts on Home”“My Latest Work” and “Latest Articles & Publications” list every project and every post as cards, but show four at a
time: the cards after the fourth carry the class hidden, and “More Projects” / “More Posts” removes it from four more
per click (the box’s data-page-size="4"). When you add a card, keep the first four without hidden and every later one
with it. With four cards or fewer, delete the button.
Posts are listed newest first, projects in the order you choose: put a new post at the top (and add hidden to the card
that becomes fifth).
Adding a project
Section titled “Adding a project”-
The page. Copy an existing one, e.g.
project/ecoshop-sustainable-e-commerce-platform.html→project/northwind-brand-refresh.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the title (
<h1>), Date (datetimeand text), Service and Client, and the cover photo (src,alt,widthandheight); - the text under “Project Overview” and “Key Highlights” (the text of a project or a post);
- the three gallery photos: two side by side, one full width (delete one you don’t need);
- “More Projects”: three other projects’ cards (the third is hidden below 1000 px);
- the
<head>: title, description, canonical,og:url, theog:andtwitter:titles and descriptions, the share image (og:image,twitter:image: the cover’s full address) andog:image:alt.
- the title (
-
Home. Copy a card in “My Latest Work” (an
<li>with its link, cover, title, summary, service and date), paste it where it should show and edit its link, photo and texts (above). -
The other projects whose “More Projects” should show it.
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/project/northwind-brand-refresh.html</loc></url>
Adding a post
Section titled “Adding a post”- The page. Copy one in
blog/and rename it. Edit the title (<h1>), Date and Category, the cover, the text, “More Posts” (up to three other posts of the same category, newest first) and the<head>as for a project, plusarticle:published_time(the date). - Home. Copy a card in “Latest Articles & Publications”, paste it at the top and edit it; add
hiddento the card that becomes fifth. - The posts of its category, whose “More Posts” should show it.
- The sitemap. Add a line to
sitemap.xml.
To remove a project or a post, do the reverse: delete the page, its cards and its line in sitemap.xml. Search the
folder for the file name to catch any link left behind.
The text of a project or a post
Section titled “The text of a project or a post”The text sits in a <div> after the cover (a project has two: under “Project Overview” and “Key Highlights”), and uses a
few tags. Copy them from a post:
| Block | HTML |
|---|---|
| Paragraph | <p class="not-first:mt-5"> |
| Heading | <h3 class="text-xl leading-[1.2] font-medium md:text-[22px] lg:text-2xl not-first:mt-10"> |
| Bulleted list | <ul class="relative list-none not-first:mt-[15px]"> with <li class="relative before:absolute before:start-0 ps-[1.25em] before:content-['•']"><p>…</p></li> |
| Numbered list | <ol …> with before:content-[counter(list-item)_'.'] on its items |
| More inside a list item | further <p> and lists after the item’s first <p> (the demo’s numbered steps) |
| Bold | <strong class="font-bold"> |
| Code | <code class="rounded-md bg-white/5 px-[0.2em] py-[0.1em] font-mono"> (Fragment Mono, loaded on the post pages) |
The classes in the table are those of the demo’s posts; copy the real tag from a post rather than typing it, so that every class is one the stylesheet already has.
Images
Section titled “Images”assets/images/ holds every photo. The easiest change is to replace a file with yours under the same name: every
page that shows it updates. The download ships with grey placeholders that state the size each image was designed for
(for example 1600 × 1066).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(project/…, blog/…), the path starts with ../: src="../assets/images/my-photo.jpg". In 404.html it starts at
the site’s root: src="/assets/images/…". The width and height on the <img> are the photo’s own size: write your
photo’s, so that the browser keeps its space while it loads.
Every photo sits in a fixed frame and is cropped to fill it (object-cover), so a photo of other proportions works, but
you lose the edges the frame cuts. Use photos at least as large as the demo’s:
| Photos | Files | Demo size |
|---|---|---|
| A project’s cover (its cards, the top of its page, its share image) | project-<name>-cover.jpg |
1600 × 1066 |
| A project’s gallery | project-<name>-1.jpg, -2.jpg (side by side), -3.jpg (full width) |
1000 wide, 1600 wide |
| A post’s cover | post-<first words of the slug>.jpg |
1600 wide |
| A service’s small photos | service-<slug>-1.jpg … -4.jpg |
300 wide (200 to 375 tall) |
| A testimonial’s photo (50 px round) | testimonial-<name>.jpg |
70 to 150 px square |
| The profile photo (80 px round; also the logo’s) | profile-javier-martinez.png |
240 × 240 |
| The client logos (30 px tall) | client-logo-1.svg … |
SVG |
Use .jpg for photos and keep files small; compress them with Squoosh or
TinyPNG. Write an alt text for every photo that carries meaning (the demo describes each one); the
client logos say alt="Client logo": write your clients’ names.
icon.png and apple-icon.png in the root are the browser icons: the profile photo in a circle, placeholders in the
download (Design).
Pages link to each other as index.html, project/<slug>.html, blog/<slug>.html; from inside a folder, add ../
(../index.html#contact). Keep the .html: it’s what lets the site work from any host and from disk. The links and
images of 404.html start at the site’s root (/index.html), because it is shown at any address.
The header’s links lead to Home’s sections: index.html#project, #service, #resume, #blog and #contact are the
ids of the sections. If you change a section’s id, change the links in every page. The social links lead to the
networks’ home pages until you change them. The mailto: link (“Email me”) opens the visitor’s mail app.
Adding a page
Section titled “Adding a page”- Copy a project page (it has the header, the column and the footer), e.g. to
about.htmlin the root. Its links and images start with../: remove that part (../index.html→index.html). - Replace the blocks inside
<main …>with the ones you want. Every block in the template can be copied from its page (or fromstyle-guide.html) and pasted between<main …>and</main>. Delete the fixed close button at the end of the page if you don’t want it. - Update the
<head>(title, description, canonical,og:url, and theog:andtwitter:titles and descriptions; remove theog:imagetags or point them at a picture of the page). - Link to it: in the header’s two menus (the row for tablets and up, and the phone menu), copy the
<li>of a neighbouring link and change itshrefand its text. Keepdata-close-menuon the phone menu’s links: it closes the menu when the link is pressed. Do it in every page. Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the menus and the cards of every page, and its line from sitemap.xml. Search
the folder for the file name to catch any link left behind.
The style guide
Section titled “The style guide”style-guide.html shows every component with its name, which is handy for copying a card or a button. It’s hidden from
search engines and linked from nowhere. Delete it before publishing if you don’t want it online.