{"repo":"benbalter/jekyll-titles-from-headings","free":true,"listed":false,"github":"https://github.com/benbalter/jekyll-titles-from-headings","clone":"git clone https://github.com/benbalter/jekyll-titles-from-headings.git","description":null,"language":"Ruby","stars":96,"topics":["jekyll-plugin","jekyll","markdown","github-pages"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"Jekyll Titles from Headings A Jekyll plugin to pull the page title from the first Markdown heading when none is specified. What it does If you have a Jekyll page that doesn't have a title specified in the YAML Front Matter, but the first non-whitespace line in the page is a Markdown H1 / H2 / H3, this plugin instructs Jekyll to use that first heading as the page's title. Why Because lots of plugins and templates rely on page.title . If you're using a plugin like Jekyll Optional Front Matter, you'd have to add Front Matter, just to get the title, which you're already specifying in the document. Additionally, this allows you to store the title semantically, in the document itself so that it's readable, both as Markdown and when rendered, as machine-readable for plugins like Jekyll SEO Tag. Usage 1. Add the following to your site's Gemfile: 2. Add the following to your site's config file: Note: If you are using a Jekyll version less than 3.5.0, use the gems key instead of plugins . Configuration Configuration options are optional and placed in config.yml under the titles from headings key. They default to: Stripping titles If your theme renders titles based on page.title , you can remove the title from the content by setting strip title to prevent rendering it twice. To limit this behavior to a certain layouts or paths, you can use front matter defaults, e.g. Processing Collections If you want to enable this plugin for collection items, set the collections option to true . Since","default_branch":null,"files":null,"tree":[],"storefront":"/r/benbalter","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/benbalter/jekyll-titles-from-headings/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}