Configuration

There is three configuration files in the blog:

  • app.config.ts in the root of the project
  • .env in the root of the project
  • nuxt.config.ts in the root of the project

.env

The .env file is used to store environment variables. With Bloggrify, you have to define the BASE_URL variable in this file.

BASE_URL=https://www.example.com

This is important for SEO and for the generation of the sitemap and the robots.txt.

app.config.ts

You can read the content of app.config.ts file to see the configuration of the blog.

You can configure

  • the url,
  • the title,
  • the description,
  • the logo,
  • the social networks (twitter, mastodon, youtube, linkedin, facebook, instagram, github) for the website
  • the top menu,
  • the list of authors
KeyTypeDefaultDescription
urlstringhttps://www.example.comThe url of the website
languagestringenThe default language of this blog
logostring/images/logo.svgThe logo to be used on the header
avatarstring/images/avatar.jpgThe logo of the main author if there is only one author.
descriptionstringlorem ipsumWebsite description
themestringdefaultThe name of the theme to be used (experimental feature)
namestringBloggrifyName of your website (used as a title on the index page)
table_of_contentsbooleanfalsewether you display the table of content on each blog post per default or not
toc.showChildrenbooleanfalsewether you display the children of the table of content on each blog post or not
Socials
socialsobject{}Social links
socials.githubstringThe repository to use on GitHub links
socials.linkedinstringThe account to use on Linkedin links
socials.twitterstringThe account to use on Twitter links
socials.youtubestringThe channel to use on Youtube links
socials.instagramstringThe account to use on Instagram links
socials.facebookstringThe account to use on Facebook links
socials.sharing_networksarrayThe list of network to display in the "share" section (if supported by the theme)
Authors
authorsarray[]if you have multiple authors, you can set them here
authors.usernamestringthe username
authors.namestringThe full name
authors.descriptionstringA text describing this author
authors.avatarstringAn avatar for this author
author.socials.twitterstringThe account to use on Twitter links
author.socials.youtubestringThe channel to use on Youtube links
author.socials.linkedinstringThe channel to use on Linkedin links
author.socials.instagramstringThe account to use on Instagram links
author.socials.facebookstringThe account to use on Facebook links
Some module can also have their own configuration. For example, the comment system, the robots.txt module, etc... Look at their respective documentation to see how to configure them.

nuxt.config.ts

Bloggrify is based on Nuxt.js. You can configure your blog by modifying the nuxt.config.ts file.

We won't detail all the configuration options of Nuxt.js here. You can find more information on the official documentation.

Some modules can also have their own configuration. For example, the sitemap module, the robots.txt module, etc...