Site settings

Site settings

Name, description, author, logo and favicon, on the Site screen or in the _index note.

The site settings are saved as properties of the _index note in the site folder. There are three ways to change them, and all of them save to the same place.

In Blup Studio: the Site screen

Click Site in the side bar. The screen shows how the site presents itself, in blocks:

  1. Name and description
    • Site name: shows at the top, in the browser tab and on Google.
    • Description: one sentence. Shows at the top, on Google and when the site is shared.
    • Author: who signs the posts that do not name an author.
  2. Logo and favicon
    • Logo: at the top of the site. Without a logo, the name shows.
    • Show the name next to the logo: when off, the top of the site shows the logo alone.
    • Favicon: the icon of the tab and of the app. Square, ideally 512 pixels or SVG.
  3. Top menu and Top button. See Menu, submenus and button.
  4. Social links. See Social links.

Each change shows up in the preview next to it right away, without reloading.

Blup setting things up

In the _index note

PropertyWhat it does
site_nameSite name: browser tab, footer and Google.
site_descriptionOne sentence about the site, for Google and social networks.
logoLogo image at the top, like "[[logo.svg]]".
header_namefalse shows only the logo at the top, without the name.
faviconBrowser tab icon, like "[[favicon.png]]".
menuItems of the top menu.
button_text and button_linkThe button at the top right.
socialLinks to your profiles, with icons in the footer.
---
title: Acme
description: The simple way to do X.
site_name: Acme
site_description: The simple way to do X.
logo: "[[acme-logo.svg]]"
favicon: "[[acme-icone.png]]"
social:
  - https://github.com/acme
  - mailto:hi@acme.com
---

From the command line

blup customize asks the same questions (name, description, author, logo, favicon, menu, social links) and saves them to the same properties.

Logo and favicon

  • In SVG, they stay sharp on any screen.
  • In PNG, Blup makes the sizes that browsers and phones ask for.
  • Without a logo, the top shows the name. Without a favicon, the site uses the mascot.

The other site screens in the Studio

ScreenWhat it sets up
SectionsThe parts of Bento. See Turn sections on and off
AuthorsThe profiles. See Authors
LanguagesThe site in other languages. See Multilingual sites
CommentsVotes, reactions and comments. See Comments and reactions
Cookies and statisticsTools and banner. See Cookies and statistics
PodcastBlogs only. See Blog podcast
PublishWhere and how the site goes live. See Publish from the Studio

What about blup.toml?

In the site folder on your computer, blup.toml keeps what is not content: where to publish, the languages, the site password and the sync repository. The Studio and blup customize change all of it without you opening the file.