Posts Directory

Documentation for the pages Directory

Overview: The pages directory in this Jekyll site contains individual Markdown (.md) files that represent different static pages of the website. Each file is written in Markdown format and contains YAML front matter for specifying metadata like layout, title, and permalink.

Directory Structure:

• about.md: The About Us page provides information about the company, team, mission, and values.
• contact.md: The Contact Us page includes details on how to reach the company, social media links, and an integrated contact form.
• faq.md: The FAQ page addresses frequently asked questions, offering quick information to common queries from users.
• portfolio.md: Showcases completed projects or case studies, highlighting the company's expertise and experience.
• privacy-policy.md: Details the company's policies regarding user data collection, usage, and protection.
• services.md: Describes the services offered by the company, along with details about each service.
• thank-you.md: A Thank You page for users who have submitted a form, providing a friendly acknowledgement.

Page Creation and Editing:

• Front Matter: Each page contains YAML front matter at the top, specifying the layout (layout: page) and the title (title: Page Title). The permalink (permalink: /url/) indicates the URL path for the page.
• Content: Below the front matter, the content of each page is written in Markdown. You can add headings, text, images, and links using standard Markdown syntax.
• Contact Form Integration: For the contact page, ensure that the form action is correctly set to integrate with services like Formspree or Netlify for form submissions.
• Image and Link Paths: When adding images or creating links, use relative URLs ({{ '/path/to/asset' | relative_url }}) for compatibility with Jekyll's build process.

Best Practices:

• Consistency: Keep a consistent style and format across all pages for a cohesive user experience.
• Regular Updates: Regularly review and update the content of these pages to ensure accuracy and relevance.
• SEO Optimization: Use descriptive titles and relevant content to improve SEO performance for each page.

Testing and Deployment:

• Before deploying updates, locally test the site (bundle exec jekyll serve) to ensure all pages are rendering correctly.
• Check for broken links, layout issues, and typos.

---

End of Documentation.

Documentation for pages Directory

The pages directory in a Jekyll website is dedicated to storing standalone pages that aren't part of the main blog post stream. These typically include pages like "About Us," "Contact," "Services," or any other static page that provides information about the site or organization.

Directory Structure and Usage

• Markdown or HTML Files: Pages can be written in Markdown (.md) or HTML (.html). Markdown is simpler and converted to HTML by Jekyll, while HTML gives more control over the page's layout and design.

• Front Matter: Each page should start with Jekyll front matter, which includes metadata like the layout, title, permalink, and any other relevant information.

• Permalinks: Custom permalinks can be defined in the front matter for each page to create clean, readable URLs.

Creating and Managing Pages

• To create a new page, add a Markdown or HTML file in the pages directory. For example, an "About" page might be about.md.

• Use the front matter to define how the page should be handled. At a minimum, you should define the layout and title.

• Organize your pages logically within the directory. For larger sites, consider using subdirectories.

Best Practices

• Consistent Naming: Use clear, descriptive filenames that reflect the content or purpose of the page.

• Navigation: If the page should be included in the site's navigation menu, ensure it is linked appropriately, often through editing the _data/navigation.yml or directly in the navigation include file.

• SEO Optimization: Include relevant metadata in the front matter for search engine optimization, such as title, description, and any relevant tags.

• Testing: Regularly test the pages for layout issues, broken links, and content accuracy, especially after significant updates to the site's design or content.

Example Front Matter for a Page

---
layout: page
title: About Us
permalink: /about/
---

This structure starts with the layout type (page), a title (About Us), and a permalink (/about/). After the front matter, the actual content of the page follows.

---