Gatsby Docs Starter 1.0
A starter skeleton with advanced features for Gatsby.
Developed for creating Documentation or Tutorial websites.
This template provides everything but the content. You could just write all your lessons in markdown files, configure a few lines of code, and have a completely built documentation website.
- Updated Table of Contents system:
- You now define your table of contents in the 'table_of_contents.json' file under the 'content' folder.
- The GraphQl query in your 'lesson' template should match your table_of_contents.
TableOfContentscomponent does the rest.
This requires more upfront work, but I've found it to be infinitely better when your page count gets high. It's easier to move things around and have the ToC just work.
For a more complicated example, you can look at the repo for the site I built this for: Flutter By Example/
- Basic styling added to the 'post' template
- Mobile responsive
- Basic UI
- Styled Components CSS w/ ThemeProvider for easy cross-site UI changes.
- Custom code-highlight theme
- React Icons
- Configured to auto generate documentation 'Table of Contents'
- You can also have blog posts.
- December 23, 2017 - The 'Docs' page is now mobile responsive.
Gatsby Advanced Starter, which remain:These are the features from
- Blazing fast loading times thanks to pre-rendered HTML and automatic chunk loading of JS files
- Separate components for everything
- High configurability:
- User information
- User social profiles
- Copyright information
- Author segment
- Follow Me button
- Posts in Markdown
- Code syntax highlighting
- Embed YouTube videos
- Embed Tweets
- Separate page for posts under each tag
- Separate page for posts under each category
- Disqus support
- Notifications about new disqus comments
- Google Analytics support
- NPM scripts for GitHub Pages deployment
- Social features
- Twitter tweet button
- Facebook share/share count
- Reddit share/share count
- Google+ share button
- LinkedIn share button
- Telegram share button
- Sitemap generation
- General description tags
- Schema.org JSONLD (Google Rich Snippets)
- OpenGraph Tags (Facebook/Google+/Pinterest)
- Twitter Tags (Twitter Cards)
- RSS feeds
- Loading progress for slow networks
- Offline support
- Web App Manifest support
- Development tools
- ESLint for linting
- Prettier for code style
- Remark-Lint for linting Markdown
- write-good for linting English prose
- gh-pages for deploying to GitHub pages
- CodeClimate configuration file and badge
WARNING: Make sure to edit
static/robots.txt to include your domain for the sitemap!