Theme Settings Files

Overview

The Deneb Jekyll theme uses multiple YAML configuration files to control various aspects of the site. This document provides a comprehensive guide to these configuration files.

_data/settings.yml

Theme Information

theme_info:
  name: Deneb Jekyll
  version: 3.0.0
  last_updated: 2025-01-27
  author: Tortoiz Themes
  description: Modern, responsive Jekyll theme for creative agencies

• Provides metadata about the theme
• Useful for displaying theme credits and version information

Site Basic Information

title: "Deneb - A Digital Agency Jekyll Theme"
email: "tortoizthemes@gmail.com"
description: "Write an awesome description for your new site"
favicon: "/assets/images/favicon.ico"
site_preloader: true

• Set site title, email, and description
• Configure favicon
• Enable/disable site preloader

Logo Configurations

logos:
  desktop:
    url: "/"
    src: "/assets/images/logo-desktop.webp"
    alt: "Deneb Digital Agency"
    width: 150
    height: 50
    class: "desktop-logo"
    img_class: "desktop-logo-image"
  
  mobile:
    url: "/"
    src: "/assets/images/logo-desktop.webp"
    alt: "Deneb Digital Agency"
    width: 120
    height: 40
    class: "mobile-logo"
    img_class: "mobile-logo-image"

• Define separate logos for desktop and mobile
• Customize logo dimensions, classes, and alt text

Call to Action (CTA) Button

cta_button:
  home_text: "Home"
  cta_text: "Hire Us"
  cta_link: "/contact/"

• Configure CTA button text and link

Social Media Links

facebook_url: "https://www.facebook.com/tortoiztheme"
twitter_url: "https://twitter.com/tortoizthemes"
instagram_url: "https://instagram.com/"

social_links:
  - platform: Facebook
    url: https://facebook.com/your-page
  - platform: Twitter
    url: https://twitter.com/your-handle

• Add social media URLs
• Create a list of social media links

Social Media and Online Presence

twitter_username: jekyllrb
github_username: jekyll

social_links:
  - platform: Facebook
    url: https://facebook.com/your-page
    icon: facebook-f

  - platform: Twitter
    url: https://twitter.com/your-handle
    icon: twitter

  - platform: Instagram
    url: https://instagram.com/your-profile
    icon: instagram

• Configure social media usernames
• Create a list of social media links with icons
• Useful for footer and contact sections

Hero and Background Image

hero_image: "/assets/images/breadcrumb_bg.webp"

• Set a default hero or breadcrumb background image
• Used across pages for consistent design

Disqus Comments Configuration

disqus:
  shortname: deneb-1  # Your Disqus shortname

• Enable site-wide comments
• Can be disabled per-post using front matter

Hire Us Section

hire_us:
  enabled: true
  heading: "Let's Work Together"
  description: "We would love to hear from you. Contact us and we'll help you achieve your goals."
  button:
    name: "Hire Us"
    link: "/contact"

• Toggle Call-to-Action section
• Customize heading, description, and button

Newsletter Subscription

newsletter:
  title: "Our Newsletter"
  description: "Subscribe to our newsletter to get our news & updates!"
  form_action: "https://formsubmit.io/send/tortoizthemes@gmail.com"
  button_text: "Join"
  placeholder: "Email Address"

• Configure newsletter signup section
• Set form submission endpoint
• Customize button and placeholder text

Contact Form Configurations

contact_forms:
  default:
    heading: "Get In Touch With Us"
    description: "We would love to hear from you."
    image: "/assets/images/contact.webp"
    form_action: "https://formsubmit.io/send/tortoizthemes@gmail.com"
    submit_button_text: "Submit Now"
    fields:
      - type: "text"
        name: "first_name"
        placeholder: "First Name"
        required: true
        column: "col-lg-6"
      
      # More form fields...
  
  detailed:
    # Alternate contact form configuration
    # Similar structure to default form

• Define multiple contact form configurations
• Customize form fields, layout, and submission endpoint
• Support for different form styles (default, detailed)

Contact Area Configuration

contact_area:
  heading: "Get In Touch With Us"
  description: "We would love to hear from you."
  image: "/assets/images/contact.webp"
  form_action: "https://formsubmit.io/send/tortoizthemes@gmail.com"
  submit_button_text: "Submit Now"

• Additional contact section configuration
• Similar to contact forms, but with a different purpose

Best Practices

• Keep configuration files well-organized
• Use meaningful descriptions
• Maintain consistent formatting
• Update information regularly
• Test changes locally before deployment

Best Practices for Configuration

• Use meaningful, descriptive text
• Keep form actions and links up-to-date
• Test form submissions
• Ensure consistent branding
• Optimize images for web performance

Troubleshooting

• Ensure all file paths are correct
• Check YAML syntax
• Verify social media and CTA links
• Confirm logo image dimensions

Troubleshooting

• Verify form submission endpoints
• Check social media link URLs
• Ensure required fields are properly configured
• Test responsive design of forms and sections

Customization Tips

• Replace placeholder content with your own
• Adjust navigation structure to match your site
• Use meaningful testimonials
• Optimize images for web performance