init
[disinclined.org.git] / _posts / 2023-02-02-welcome-to-jekyll.markdown
1 ---
2 layout: post
3 title:  "Welcome to Jekyll!"
4 date:   2023-02-02 20:22:38 -0500
5 categories: jekyll update
6 ---
7 You’ll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run `jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated.
8
9 Jekyll requires blog post files to be named according to the following format:
10
11 `YEAR-MONTH-DAY-title.MARKUP`
12
13 Where `YEAR` is a four-digit number, `MONTH` and `DAY` are both two-digit numbers, and `MARKUP` is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works.
14
15 Jekyll also offers powerful support for code snippets:
16
17 {% highlight ruby %}
18 def print_hi(name)
19   puts "Hi, #{name}"
20 end
21 print_hi('Tom')
22 #=> prints 'Hi, Tom' to STDOUT.
23 {% endhighlight %}
24
25 Check out the [Jekyll docs][jekyll-docs] for more info on how to get the most out of Jekyll. File all bugs/feature requests at [Jekyll’s GitHub repo][jekyll-gh]. If you have questions, you can ask them on [Jekyll Talk][jekyll-talk].
26
27 [jekyll-docs]: https://jekyllrb.com/docs/home
28 [jekyll-gh]:   https://github.com/jekyll/jekyll
29 [jekyll-talk]: https://talk.jekyllrb.com/