Editing the site — Goeboek HTML
Every page of Goeboek’s HTML edition is a plain file you edit in a code editor: where everything is, and how to change the texts, add a property, a post or an agent, 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 Homeproperty.html every property, six at a time, beside the filtertype/sell.html the properties for sale (6 in the demo)type/rent.html the properties for rent (15)location/*.html one listing per location (6, with No Location)property-category/*.html one listing per category (5, with Uncategory)agent/*.html one listing per agent, with the agent's card (4, with No Name)property/*.html one page per property (21)blog.html every postblog/*.html one page per post (12)about.html, contact.htmladd-property.html the form to submit a propertysuccess-scheduled.html where "Schedule tour" leads once sentsuccess-add-property.html where Add property leads once sent404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)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, the logo's mark and the two thank-you illustrationsassets/fonts/ Plus Jakarta Sans, Intericon.png, apple-icon.png the browser icon and the home-screen iconsitemap.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 property card’s title looks like this:
<h3 class="text-xl leading-[1.2] font-medium md:text-[22px] lg:text-2xl w-full"> <a href="property/south-sunlight-apartment.html" …>South Sunlight Apartment</a></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 &, and the demo uses both ’ and the typographic ’
(Let’s Talk). Typing ' and " in text works too; & should stay &.
Dates are written twice: <time datetime="2024-05-16">May 16, 2024</time>. The datetime is the date in
year-month-day form, 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 and the footer 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://goeboek-html-marcframe.vercel.app |
Your domain, e.g. https://www.youragency.com (canonical links, share cards, sitemap.xml, robots.txt) |
aria-label="Goeboek" |
Your name: the name of the logo links, for screen readers |
<span class="block">Goeboek</span> and <span class="block">properties</span> |
The two lines of your name in the logo (Design) |
Goeboek by Marcframe. All rights reserved. |
Your footer line (the year before it is written by the script: <span data-current-year>) |
| Goeboek</title> and | Goeboek" in share tags |
| Your Agency (Home’s title, Goeboek - Real Estate and Property Website, has no suffix) |
content="Goeboek" |
Your site’s name (application-name and og:site_name) |
Goeboek is your trusted partner in real estate, … |
The footer’s text (also the “about” box of every post page) |
123 Main Street, Suite 456, Cityville, ST 78901 |
Your address (the footer, and contact.html with its map) |
(123) 456-7890 and tel:1234567890, (987) 654-3210 and tel:9876543210 |
Your phone numbers: the text and the link (digits only) |
hello@example.com |
Your e-mail (the footer and contact.html) |
https://instagram.com, https://facebook.com, https://youtube.com, https://x.com |
Your profiles (the footer’s “Follow us:”) |
Include the .html, .xml and .txt files. Review each change before replacing all. “Goeboek” also appears inside
the texts (the About page, the call to action, the forms’ introductions, the descriptions): search for it once you are
done.
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 logo, the text, the contacts, the two link columns, the copyright and the social links | Every page |
| A property’s card | property.html, the listings of its type, location, category and agent, other properties’ “More in” and “Related properties”, Home (the first ten), “Latest Property” on every post (the first property) |
| A post’s card | blog.html, Home (the four newest), “Recent posts” on every post (the three newest), the related posts of the posts of its category |
| An agent’s photo and name | Every card of that agent’s properties; the agent’s card on their own page and on their properties’ pages |
| The call to action (“Let Us Help You Find the Perfect Home Today”) | Home and About |
| The filter (Type, Category, Location, Agents) | Every listing page |
Search the folder for a property’s or a post’s file name (south-sunlight-apartment) to find every card of it.
Home, section by section
Section titled “Home, section by section”index.html holds, in order:
- The hero: the title (the page’s
<h1>), the text and “See all Property”; the two numbers (“150 Property Available”, “87 Property Sold”); “Top Testimonial” with five testimonials in a slideshow and “More Details” (toabout.html#testimonials); then the first four properties as large cards in a slideshow, each with its photo, beds, bath and size, price, agent and “Request a tour” (to the property’s page). - Featured Properties Just for You: six property cards (the fifth to tenth properties of the demo) and “More Property”.
- About Us: the title, the two texts, two photos and “More about Us”.
- The call to action: the photo, the texts, “Get Started” and “Contact Us”.
- Stay Updated with Our Latest Insights: the four newest posts.
The slideshows are boxes marked data-slideshow, with data-count (the number of slides: 5 testimonials, 4
properties) and data-interval (milliseconds between slides: 4000 and 8000). Each list is written with its first slide
repeated at the end (so the loop has no gap); the properties’ slideshow also has one dot button per slide. When you add
or remove a slide, do it in the list, in the copy at the end if it is the first, and in the dots, and set data-count.
Property cards
Section titled “Property cards”A property card shows the photo, the type (“For Rent”, “For Sale”), the agent’s photo and name, the category and the
location, the title, the first sentence of the description, the price and the size, beds and baths. On hover it runs
through three photos — the card photo and the first two gallery photos — in a slideshow written inside the card
(data-slideshow, data-count="3", hidden until hovered). Copy a whole <li> with its <article data-property-card>
and change the links, the photos (in the card and in its slideshow) and the texts.
Listings
Section titled “Listings”property.html lists every property and shows six at a time: the cards after the sixth carry hidden tabindex="-1",
and “Load More” shows six more per click (the box’s data-page-size="6"; data-count is the number of cards). When you
add a card, keep the first six without hidden and every later one with it.
The type, location, category and agent pages list their properties all at once, without “Load More”. The filter beside
them is links to the other listings (type/sell.html, location/brooklyn.html …), with the current one marked
(aria-current="page"); on phones it folds behind a button. The three empty defaults (No Location, Uncategory, No Name)
are not in it. A new location, category or agent needs its own listing page and a link in the filter
of every listing page.
Adding a property
Section titled “Adding a property”-
The page. Copy an existing one, e.g.
property/south-sunlight-apartment.html→property/garden-loft.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the type, the title (
<h1>), the category and location links, the Property ID, the price (with/monthfor a rental), the size; - “Contact Sales” (a
tel:link to the agent’s mobile); - the main photo and the four gallery photos (
src,alt,widthandheight); - Description and Property features (the text of a property or a post), the details and the utilities;
- the video (
src="https://www.youtube.com/embed/<video id>"on the<iframe>, and itstitle), the address and the “Show on map” link (a Google Maps search of the address); - the agent’s card (photo, name, phones, WhatsApp, e-mail, “View My Property”);
- “Schedule tour”: the
valueandplaceholderof the Property ID and Property Name fields; - “More in
”: two other properties of the same location; “Related properties”: up to four of the same category and type (the fourth is hidden from 1200 px); - the
<head>: title, description, canonical,og:url, theog:andtwitter:titles and descriptions, the share image (og:image,twitter:image: the main photo’s full address) and its alt text.
- the type, the title (
-
The listings. Add its card (property cards) to
property.htmland to the listings of its type, location, category and agent. -
The other properties whose “More in” or “Related properties” should show it, and Home if it should be featured.
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/property/garden-loft.html</loc></url>
Adding a post
Section titled “Adding a post”- The page. Copy one in
blog/and rename it. Edit the title (<h1>), the date, the category, “By Javier Marc”, the cover, the text, the related posts at the bottom (up to four other posts of the same category, newest first) and the<head>as for a property. - The lists. Put its card at the top of
blog.htmland of Home’s latest posts (and remove the card that becomes fifth there), and in “Recent posts” of every post (the three newest). - The posts of its category, whose related posts should show it.
- The sitemap. Add a line to
sitemap.xml.
To remove a property 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.
Agents
Section titled “Agents”An agent page (agent/steve-parker.html) shows the agent’s card — photo, address, office phone, mobile, WhatsApp
(https://wa.me/<number>), e-mail and text — above the filter, and the agent’s properties. To add an agent, copy a page
in agent/, change the card and the cards it lists, add the agent to the filter’s “Agents” of every listing page and to
sitemap.xml. The agent’s photo and name are also on each of their property cards and property pages.
The text of a property or a post
Section titled “The text of a property or a post”The text sits in a <div> (a property has two: under “Description” and “Property features”), and uses two tags:
| Block | HTML |
|---|---|
| Paragraph | <p class="not-first:mt-5"> |
| Bold | <strong class="font-bold"> |
The demo’s texts are paragraphs with a few bold words (often the property’s name). Copy the tags from a page rather than typing them, 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 1024 × 644).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(property/…, blog/…, agent/…), 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 property’s photo (its cards, the top of its page, its share image) | property-<slug>.jpg |
300 to 1400 wide (most 1024 × 644 or 1400 × 785); about 1.5 : 1 on the cards, 16 : 9 on its page |
| A property’s gallery | property-<slug>-2.jpg … -5.jpg |
300 to 1200 wide; 16 : 9 tiles |
| A post’s cover | post-<slug>.jpg |
1400 wide |
| An agent’s photo (round) | agent-<slug>.jpg |
400 × 504 |
| A testimonial’s photo (round, 24 px) | testimonial-<name>.jpg |
70 to 200 px |
| About’s photo, the call to action | about-hero.jpg, cta.jpg |
1920 wide |
| The About photos (Home and About) | about-1.jpg, about-2.jpg |
1200 × 800, 1200 × 1800 |
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 logo’s mark (logo-mark.svg) and the thank-you illustrations (success-tour.svg, success-property.svg) are drawings, not
placeholders.
Pages link to each other as index.html, property/<slug>.html, blog/<slug>.html; from inside a folder, add ../
(../contact.html). 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 phone numbers are tel: links (digits only), the e-mails mailto: links, WhatsApp https://wa.me/<number>. The
social links lead to the networks’ home pages until you change them.
Adding a page
Section titled “Adding a page”- Copy a page that has the layout you want, e.g.
about.htmltoservices.htmlin the root. - 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>. - 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 menu, copy the
<li>of a neighbouring link and change itshrefand its text. Keepdata-close-menuon the links: it closes the phone menu when the link is pressed. Do it in every page, or add the link to a column of the footer. Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the menus, the footer, the filters 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.