This is the GitHub repository for the project you named "toDoc", generated from the "yaxt-blackledge-infocards" website template at yax.com.
From here, deploy your website for free hosting. Just click a button to deploy your website to Netlify, Vercel, or Render.com. During the process, you will create a second repo for deployment. Name it what you like; I suggest "toDoc-deploy".
For help, open a GitHub issue and mention DanielKehoe or email [email protected].
It is early days for Yax. If you are curious about what we are doing, go to stackless.community and sign up for the newsletter, all about Yax and building websites without frameworks or build tools.
This is a website built using the yax.com website builder project. It was designed by the Yax team for Peter Blackledge, the first subscriber to the Yax Tutorials.
The website is styled with the Basic.css stylesheet by Vladimir Carrer. No CSS classes are needed; styles are applied using only HTML5 tags.
The website has a home page, about page, and an unlimited number of content pages.
This template doesn't use an on-page editor. Instead, you can edit the files directly on GitHub. Click a filename and look for the "Edit this file" pen icon. After committing your changes (which saves the file), your website will automatically update (if you are editing files created in a repo that was previously deployed to Netlify, Vercel, or Render.com).
Content for each page comes from Markdown files. Markdown is well-suited for content and easier to edit than HTML. The name of each Markdown file matches the HTML file for each page (so the about.html page gets content from an about.md file). The home page gets content from two Markdown files, index-intro.md and index-closing.md for intro and closing sections.
The home page contains a title which is read from a file named manifest.json. The home page also displays an unlimited number of "information cards" each containing a title, summary, and link to a content page. The content for the cards is read from the manifest.json file.
Edit the manifest.json file to change the home page title or the information cards.
Add or remove pages from the manifest.json list to add or remove cards on the home page. Files for the content pages are in the content folder. It contains nine pairs of .html and .md files. Duplicate an .html and .md file if you need another content page (be sure to add it to the list in the manifest.json file).
Edit the about.md file to change the about page.
Each page has a navbar with links to the home page and about page. The navbar is generated by a custom tag, , created in JavaScript. You can edit the file assets/scripts/yax-blackledge-navbar.js to add or change links.
The website uses five HTML custom elements:
<yax-blackledge-cards>: readsmanifest.jsonand displays cards<yax-blackledge-navbar>: navigation<yax-blackledge-title>: readsmanifest.jsonand displays a title<yax-markdown>: reads Markdown files to display content<yax-blackledge-heading>: displays title/summary on content pages frommanifest.json
On the home page, you can change the number of cards displayed per row by editing the index.html file. For example, change <yax-blackledge-cards cards_per_row="3"> to <yax-blackledge-cards cards_per_row="4">.