tutorials/_config.yml at main · raphaelmansuy/tutorials · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
# Jekyll Configuration for Substack-like Blog

title: "Cloud & DevOps Training Hub"
description: "A comprehensive collection of hands-on tutorials covering cloud computing, DevOps, and modern development practices"
author: "Your Name"
email: "your-email@example.com"

# Site URL (replace with your actual GitHub Pages URL)
url: "https://your-username.github.io"
baseurl: "/tutorials"

# Build settings
markdown: kramdown
highlighter: rouge
permalink: /:year/:month/:day/:title/

# Plugins
plugins:
  - jekyll-feed
  - jekyll-sitemap
  - jekyll-seo-tag
  - jekyll-paginate

# Pagination
paginate: 5
paginate_path: "/page:num/"

# Social Media & Analytics
github_username: your-username
github_repo: tutorials
twitter_username: your-twitter
linkedin_username: your-linkedin
google_analytics: G-XXXXXXXXXX

# Newsletter & Comments (Giscus)
giscus_repo_id: "your-repo-id"
giscus_category_id: "your-category-id"

# Exclude files from processing
exclude:
  - README.md
  - .github/
  - .gitignore
  - Gemfile
  - Gemfile.lock
  - .vscode/
  - .pytest_cache/
  - .venv/
  - node_modules/
  - package.json
  - package-lock.json

# Include files
include:
  - _pages
  - assets

# Collections
collections:
  tutorials:
    output: true
    permalink: /:collection/:name/

# Default values for all pages
defaults:
  # Posts
  - scope:
      path: ""
      type: "posts"
    values:
      layout: "post"
      author: "Your Name"
      comments: true

  # Tutorial files (your existing .md files)
  - scope:
      path: ""
      type: "pages"
    values:
      layout: "post"
      author: "Your Name"
      comments: true

  # Pages
  - scope:
      path: "_pages"
      type: "pages"
    values:
      layout: "default"

# SEO and Social
twitter:
  username: your-twitter
  card: summary_large_image

social:
  name: Your Name
  links:
    - https://twitter.com/your-twitter
    - https://github.com/your-username
    - https://linkedin.com/in/your-linkedin

# Logo and social preview
logo: "/assets/images/logo.png"
social_preview: "/assets/images/social-preview.png"

# Reading time calculation
reading_time: true

# Features
show_excerpts: true
show_reading_time: true
show_social_sharing: true
show_newsletter_signup: true
show_related_posts: true

# Comments via Giscus (GitHub Discussions)
comments:
  provider: "giscus"
  giscus:
    repo: "your-username/tutorials"
    repo_id: "your-repo-id"
    category: "General"
    category_id: "your-category-id"
    mapping: "pathname"
    reactions_enabled: true
    theme: "light"

# Newsletter integration
newsletter:
  provider: "convertkit" # or "mailchimp", "buttondown", etc.
  convertkit:
    form_id: "your-form-id"

# Analytics
analytics:
  google: "G-XXXXXXXXXX"

# Performance
compress_html:
  clippings: all
  comments: all
  endings: all
  startings: [html, head, body]

# Development settings
incremental: true
livereload: true
open_url: true