### Install npm Dependencies Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/advanced-customisation/index.md Navigate to the theme directory and install project dependencies using npm. This is a prerequisite for running the Tailwind compiler. ```shell cd themes/blowfish npm install ``` -------------------------------- ### Tabs Shortcode Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.it.md Use the tabs shortcode to present different variants of a step, such as installation instructions for different platforms. ```html {{ {{ Install using Chocolatey: ```pwsh choco install vscode.install ``` or install using WinGet ```pwsh winget install -e --id Microsoft.VisualStudioCode ``` {{ {{ ```bash brew install --cask visual-studio-code ``` {{ {{ See [documentation](https://code.visualstudio.com/docs/setup/linux#_install-vs-code-on-linux). {{ {{ }} ``` -------------------------------- ### Install Git, Hugo, and GitHub CLI Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Installs essential development tools: Git for version control, Hugo for static site generation, and GitHub CLI for interacting with GitHub from the command line. ```bash brew install git brew install hugo brew install gh ``` -------------------------------- ### Install Blowfish CLI Tool Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/configuration/index.md Use this command to install the Blowfish CLI tool globally, which assists with theme installation and configuration. ```bash npx blowfish-tools ``` -------------------------------- ### Install npm Dependencies Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/advanced-customisation/index.it.md Before running the Tailwind compiler, navigate to the `themes/blowfish/` directory and install the necessary project dependencies using npm. ```shell cd themes/blowfish npm install ``` -------------------------------- ### Example Directory Structure Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/installation/index.md This shows the expected file structure within the `config/_default/` directory after copying theme configuration files. ```shell config/_default/ ├─ hugo.toml ├─ languages.en.toml ├─ markup.toml ├─ menus.en.toml ├─ module.toml # if you installed using Hugo Modules └─ params.toml ``` -------------------------------- ### Run Blowfish CLI Tool Source: https://github.com/nunocoracao/blowfish/blob/main/README.md Execute the Blowfish CLI tool to start an interactive setup process for a new Hugo project and theme configuration. ```shell blowfish-tools ``` -------------------------------- ### Initialize Hugo Site Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/installation/index.md Create a new Hugo site in a directory named 'mywebsite'. This is the first step for manual installation. ```shell hugo new site mywebsite ``` -------------------------------- ### Install Homebrew Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Installs Homebrew, a package manager for macOS, which simplifies the installation of other development tools. ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` -------------------------------- ### Install Firebase CLI Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Installs the Firebase command-line interface using Homebrew. Ensure you have Homebrew installed on macOS. ```bash brew install firebase ``` -------------------------------- ### Serve Hugo Site Locally Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Starts the Hugo development server to preview your site. Access it at https://localhost:1313. ```bash hugo server ``` -------------------------------- ### Install Firebase CLI Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Installs the Firebase Command Line Interface using Homebrew. Ensure you have Homebrew installed or follow official Firebase CLI installation instructions for other operating systems. ```bash brew install firebase-cli ``` -------------------------------- ### Language Configuration Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/getting-started/index.md Configure the title and author details for your website in the `languages.en.toml` file. The author image should be in the `assets/` folder, and links are displayed in order. ```toml # config/_default/languages.en.toml title = "My awesome website" [params.author] name = "My name" image = "img/author.jpg" headline = "A generally awesome human" bio = "A little bit about me" links = [ { twitter = "https://twitter.com/username" } ] ``` -------------------------------- ### Run Blowfish Tools Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/_index.md Execute the Blowfish command-line tools to manage your project. Ensure you have Node.js and npm installed. ```shell npx blowfish-tools ``` -------------------------------- ### Install Blowfish CLI Tool Source: https://github.com/nunocoracao/blowfish/blob/main/README.md Install the Blowfish CLI tool globally using npm. This tool assists in setting up a new Hugo project with the Blowfish theme. ```shell npm i -g blowfish-tools ``` -------------------------------- ### Hugo Configuration Files Structure Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Example directory structure for Blowfish theme configuration files. ```md config/_default/ ├─ hugo.toml ├─ languages.en.toml ├─ markup.toml ├─ menus.en.toml └─ params.toml ``` -------------------------------- ### Lead Shortcode Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.it.md Use the `lead` shortcode to emphasize the beginning of an article or highlight important information. Wrap any Markdown content within this shortcode. ```markdown {{ When life gives you lemons, make lemonade. {{}} ``` -------------------------------- ### Create New Site with Blowfish CLI Source: https://github.com/nunocoracao/blowfish/blob/main/README.md Use the Blowfish CLI to create a new Hugo site and install the theme in a single command. The CLI provides further help for options. ```shell blowfish-tools new mynewsite ``` -------------------------------- ### Doughnut Chart with Chart.js Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/samples/charts/index.it.md Use this example to generate a doughnut chart. It allows for defining data, labels, background colors, and hover offset. ```html {{< chart >}} type: 'doughnut', data: { labels: ['Red', 'Blue', 'Yellow'], datasets: [{ label: 'My First Dataset', data: [300, 50, 100], backgroundColor: [ 'rgba(255, 99, 132, 0.7)', 'rgba(54, 162, 235, 0.7)', 'rgba(255, 205, 86, 0.7)' ], borderWidth: 0, hoverOffset: 4 }] } {{< /chart >}} ``` -------------------------------- ### Custom Projects List Layout Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/content-examples/index.it.md Create a custom `list.html` template for a specific section (e.g., 'projects') to define how its content is displayed. This example iterates through pages in the section and renders project details with icons. ```go {{ define "main" }}
{{ range .Pages }}
{{ partial "icon.html" .Params.icon }}

{{ .Title }}

{{ .Description }}

{{ end }}
{{ end }} ``` -------------------------------- ### Mermaid Sequence Diagram Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/samples/diagrams-flowcharts/index.md Embed sequence diagrams using the mermaid shortcode. This example includes automatic numbering and parallel actions. ```mermaid sequenceDiagram autonumber par Action 1 Alice->>John: Hello John, how are you? and Action 2 Alice->>Bob: Hello Bob, how are you? end Alice->>+John: Hello John, how are you? Alice->>+John: John, can you hear me? John-->>-Alice: Hi Alice, I can hear you! Note right of John: John is perceptive John-->>-Alice: I feel great! loop Every minute John-->Alice: Great! end ``` -------------------------------- ### Project Front Matter Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/content-examples/index.it.md Define metadata for individual project pages using front matter. This data, such as title, icon, description, and external URL, can be accessed in list templates. ```yaml --- title: "Blowfish" date: 2021-08-11 icon: "github" description: "A theme for Hugo built with Tailwind CSS." topics: ["Hugo", "Web", "Tailwind"] externalUrl: "https://github.com/nunocoracao/blowfish/" --- ``` -------------------------------- ### List Shortcode with Filtering and Card View Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.it.md This `list` shortcode example demonstrates filtering articles by 'Type' with the value 'sample', enabling card view, setting a title, and limiting the results to 6. ```markdown {{}} ``` -------------------------------- ### Basic Tabs Shortcode Usage Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.md Demonstrates the basic structure of the tabs shortcode with different content for each tab, including platform-specific installation commands. The `md=false` parameter is shown to allow nested shortcodes within tab content. ```markdown {{}} {{}} Install using Chocolatey: ```pwsh choco install vscode.install ``` or install using WinGet ```pwsh winget install -e --id Microsoft.VisualStudioCode ``` {{}} {{}} ```bash brew install --cask visual-studio-code ``` {{}} {{}} {{}}See [documentation](https://code.visualstudio.com/docs/setup/linux#_install-vs-code-on-linux).{{}} {{}} {{}} ``` -------------------------------- ### Taxonomy Configuration Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/content-examples/index.md Defines a taxonomy named 'animals' in the site's configuration file. This is a necessary step to use taxonomies in Hugo. ```toml animals = "animals" ``` -------------------------------- ### Hugo TOML Configuration Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md Example TOML structure for Hugo configuration, including theme declaration. Ensure the 'theme = "blowfish"' line is uncommented in hugo.toml. ```toml theme = "blowfish" ``` -------------------------------- ### Add Custom Font and Apply Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/advanced-customisation/index.md Include a custom font file in the static fonts directory and then reference it in your custom CSS. This example shows how to set the font for the entire HTML document. ```shell . ├── assets │ └── css │ └── custom.css ... └─── static └── fonts └─── font.ttf ``` ```css @font-face { font-family: font; src: url('/fonts/font.ttf'); } html { font-family: font; } ``` -------------------------------- ### Netlify Configuration for Blowfish Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/hosting-deployment/index.it.md This `netlify.toml` file configures build settings for a Hugo site on Netlify. It specifies build commands, environment variables, and Hugo versions. Adjust the build command if Blowfish is not installed as a Hugo module. ```toml # netlify.toml [build] command = "hugo mod get -u && hugo --gc --minify -b $URL" publish = "public" [build.environment] NODE_ENV = "production" GO_VERSION = "1.16" TZ = "UTC" # Set to preferred timezone [context.production.environment] HUGO_VERSION = "0.104.1" HUGO_ENV = "production" [context.deploy-preview.environment] HUGO_VERSION = "0.104.1" ``` -------------------------------- ### Create Project Directory and Navigate Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Creates a new directory for your project and changes the current directory to it. Replace 'blowfish-tutorial' with your desired project name. ```bash mkdir blowfish-tutorial cd blowfish-tutorial ``` -------------------------------- ### Login and Initialize Firebase Hosting Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Logs you into your Firebase account and initializes Firebase Hosting for your project. Follow the prompts to configure your project settings. ```bash firebase login firebase init ``` -------------------------------- ### Admonition Shortcode - Customization Guide Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.md Refer to the admonition customization guide for details on how to customize admonition appearance and behavior. ```markdown > [!INFO]- Customize admonition > See the [admonition customization guide](https://github.com/nunocoracao/blowfish/blob/main/layouts/_default/_markup/render-blockquote.html). ``` -------------------------------- ### Mermaid Flowchart Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/samples/diagrams-flowcharts/index.md Use the mermaid shortcode to embed flowchart definitions. This example demonstrates a basic flowchart structure. ```mermaid graph TD A[Christmas] -->|Get money| B(Go shopping) B --> C{Let me think} B --> G[/Another/] C ==>|One| D[Laptop] C -->|Two| E[iPhone] C -->|Three| F[Car] subgraph Section C D E F G end ``` -------------------------------- ### Create New Hugo Site Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Initializes a new Hugo website in the current directory. Use `--force` to overwrite existing files if necessary. ```bash hugo new site --force . ``` -------------------------------- ### Mermaid Class Diagram Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/samples/diagrams-flowcharts/index.md Define class diagrams with the mermaid shortcode. This example shows inheritance, composition, and class members. ```mermaid classDiagram Animal "1" <|-- Duck Animal <|-- Fish Animal <--o Zebra Animal : +int age Animal : +String gender Animal: +isMammal() Animal: +mate() class Duck{ +String beakColor +swim() +quack() } class Fish{ -int sizeInFeet -canEat() } class Zebra{ +bool is_wild +run() } ``` -------------------------------- ### Initialize Hugo Modules Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/installation/index.md Initialize Hugo modules for your project. Use 'github.com//' if managing on GitHub, or a local name otherwise. ```shell # If you're managing your project on GitHub hugo mod init github.com// # If you're managing your project locally hugo mod init my-project ``` -------------------------------- ### Configure Main and Footer Menus Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/getting-started/index.md Define the main navigation in the header and the footer menu using TOML. Use `pageRef` for internal links and `url` for external ones. Icons can be added with the `pre` parameter. ```toml # config/_default/menus.toml [[main]] name = "Blog" pageRef = "posts" weight = 10 [[main]] name = "Topics" pageRef = "topics" weight = 20 [[main]] pre = "github" name = "GitHub" url = "https://github.com/nunocoracao/blowfish" weight = 30 [[main]] identifier = "github2" pre = "github" url = "https://github.com/nunocoracao/blowfish" weight = 40 [[footer]] name = "Privacy" url = "https://external-link" ``` -------------------------------- ### Configure Author Details in languages.en.toml Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Sets up author information such as name, image, headline, and bio. Ensure 'profile.jpg' is in the assets folder or update the filename. ```bash [author] name = "Your name here" image = "profile.jpg" headline = "I'm only human" bio = "A little bit about you" # appears in author card for each article ``` -------------------------------- ### Mermaid Entity Relationship Diagram Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/samples/diagrams-flowcharts/index.md Create entity relationship diagrams using the mermaid shortcode. This example illustrates relationships between entities like CUSTOMER and ORDER. ```mermaid erDiagram CUSTOMER }|..|{ DELIVERY-ADDRESS : has CUSTOMER ||--o{ ORDER : places CUSTOMER ||--o{ INVOICE : "liable for" DELIVERY-ADDRESS ||--o{ ORDER : receives INVOICE ||--|{ ORDER : covers ORDER ||--|{ ORDER-ITEM : includes PRODUCT-CATEGORY ||--|{ PRODUCT : contains PRODUCT ||--o{ ORDER-ITEM : "ordered in" ``` -------------------------------- ### Youtube Lite Embed with Start Parameter Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.md Embed a YouTube video and specify a start time using the 'params' attribute. The video will begin playing at the designated second. ```shortcode {{}} ``` -------------------------------- ### Initialize Local Git Repository Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Initializes a new Git repository in the current directory with the main branch set to 'main'. ```bash git init -b main ``` -------------------------------- ### Leaf Page Front Matter Example Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/content-examples/index.it.md Define front matter for a leaf page, including title, date, description, summary, and tags. This example demonstrates standard front matter parameters for a blog post. ```yaml --- title: "My First Blog Post" date: 2022-01-25 description: "Welcome to my blog!" summary: "Learn more about me and why I am starting this blog." tags: ["welcome", "new", "about", "first"] --- _This_ is the content of my blog post. ``` -------------------------------- ### Configure Author Details Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Sets up author information such as name, image, and headline in `languages.en.toml`. The 'image' field should reference a file in the 'assets' folder. ```toml [author] name = "Your name here" image = "profile.jpg" headline = "I'm only human" bio = "A little bit about you" # appears in author card for each article ``` -------------------------------- ### Initialize Git Repository Source: https://github.com/nunocoracao/blowfish/blob/main/README.md Initialize a new Git repository in your project directory. This is the first step when using git submodules to manage the Blowfish theme. ```shell git init ``` -------------------------------- ### Emphasize Introductory Text with Lead Shortcode Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.md The lead shortcode is used to style an introduction or call out important information at the beginning of an article. Any Markdown content wrapped in this shortcode will be emphasized. ```markdown {{ When life gives you lemons, make lemonade. {{}} ``` -------------------------------- ### List Shortcode with Limit Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.it.md The `list` shortcode displays recent articles. This example shows a basic usage with a limit of 2 articles. ```markdown {{}} ``` -------------------------------- ### Article with Thumbnail Image Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/thumbnails/index.it.md Place an image file starting with 'feature*' in the article's main directory to enable thumbnails. ```shell content └── awesome_article ├── index.md └── featured.png ``` -------------------------------- ### Mermaid Diagram Shortcode Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.it.md The `mermaid` shortcode allows you to create diagrams and visualizations using Mermaid syntax. This example shows a simple flowchart. ```mermaid {{ graph LR; A[Lemons]-->B[Lemonade]; B-->C[Profit] {{}} ``` -------------------------------- ### Update Blowfish Theme Source: https://github.com/nunocoracao/blowfish/blob/main/README.md Update the Blowfish theme to the latest release using the `hugo mod get -u` command from your project directory. ```shell hugo mod get -u ``` -------------------------------- ### Basic Hugo Configuration Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/getting-started/index.md Set the `baseURL` and `languageCode` in your `hugo.toml` file for a new Blowfish installation. Ensure `languageCode` matches your primary content language. ```toml # config/_default/hugo.toml baseURL = "https://your_domain.com/" languageCode = "en" ``` -------------------------------- ### Include KaTeX Shortcode Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/samples/mathematical-notation/index.it.md Include the `katex` shortcode to enable KaTeX asset bundling and rendering of mathematical notation. ```html {{}} ``` -------------------------------- ### Update Theme using Git Submodule Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/installation/index.md Use this command to update the Blowfish theme if it was installed as a Git submodule. This fetches the latest version and merges it into your local repository. ```git git submodule update --remote --merge ``` -------------------------------- ### Create a Normal Gallery Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.it.md Use the gallery shortcode to display multiple images. Assign a class like `grid-wXX` to each image to define its column width. Widths range from 10% to 100% in 5% increments. ```html {{ {{}} ``` -------------------------------- ### Create a New Blog Post with Front Matter Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Define the title, date, draft status, summary, and tags for a new blog post using Markdown front matter. ```md --- title: "My first post" date: 2023-08-14 draft: false summary: "This is my first post on my site" tags: ["space"] --- ## A sub-title Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi nibh nisl, vulputate eu lacus vitae, maximus molestie libero. Vestibulum laoreet, odio et sollicitudin sollicitudin, quam ligula tempus urna, sed sagittis eros eros ac felis. In tristique tortor vitae lacinia commodo. Mauris venenatis ultrices purus nec fermentum. Nunc sit amet aliquet metus. Morbi nisl felis, gravida ac consequat vitae, blandit eu libero. Curabitur porta est in dui elementum porttitor. Maecenas fermentum, tortor ac feugiat fringilla, orci sem sagittis massa, a congue risus ipsum vel massa. Aliquam sit amet nunc vulputate, facilisis neque in, faucibus nisl. ``` -------------------------------- ### Leaf Page Directory Structure Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/content-examples/index.md Demonstrates the structure for leaf pages, which are standalone content pages without sub-pages. This includes examples of naming conventions and page bundles. ```shell . └── content └── blog ├── first-post.md # /blog/first-post ├── second-post.md # /blog/second-post └── third-post ├── index.md # /blog/third-post └── image.jpg ``` -------------------------------- ### Image Carousel Shortcode (16:9) Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.md Showcases multiple images in an interactive carousel. This example uses a specific list of image URLs and local paths with a default 16:9 aspect ratio. ```markdown {{}} ``` -------------------------------- ### Article Folder Structure for Thumbnails Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/thumbnails/index.md For single Markdown files, convert them into a folder structure with `index.md` to support thumbnail images. ```shell content └── awesome_article └── index.md ``` -------------------------------- ### Directory Structure for Leaf Pages Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/content-examples/index.it.md Structure content for leaf pages, which are standalone content items without sub-pages. This example shows how to organize blog posts, including those with bundled assets. ```shell .\ └── content\ └── blog\ ├── first-post.md # /blog/first-post ├── second-post.md # /blog/second-post └── third-post ├── index.md # /blog/third-post └── image.jpg ``` -------------------------------- ### Initialize Hugo Modules Source: https://github.com/nunocoracao/blowfish/blob/main/README.md Initialize Hugo Modules in your project directory. This is required when managing the Blowfish theme using Hugo's module system. ```shell hugo mod init github.com// ``` -------------------------------- ### Basic Blowfish Project Structure Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/getting-started/index.md An overview of a typical Blowfish project structure, highlighting the placement of assets, configuration files, and content within the `content` folder. ```shell . ├── assets │ └── img │ └── author.jpg ├── config │ └── _default ├── content │ ├── _index.md │ ├── about.md │ └── posts │ ├── _index.md │ ├── first-post.md │ └── another-post │ ├── aardvark.jpg │ └── index.md └── themes └── blowfish ``` -------------------------------- ### Youtube Lite Embed with Multiple Parameters Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/docs/shortcodes/index.md Embed a YouTube video with multiple playback parameters, such as start time, end time, and disabling controls. Parameters are concatenated using the '&' character. ```shortcode {{}} ``` -------------------------------- ### Configure Blowfish Homepage Layout Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md Set the homepage layout to 'background', configure the homepage image, and enable recent item display with card view. ```bash [homepage] layout = "background" # valid options: page, profile, hero, card, background, custom homepageImage = "image.jpg" # used in: hero, and card showRecent = true showRecentItems = 6 showMoreLink = true showMoreLinkDest = "/posts/" cardView = true cardViewScreenWidth = false layoutBackgroundBlur = true # only used when layout equals background ``` -------------------------------- ### Create .gitignore File Source: https://github.com/nunocoracao/blowfish/blob/main/exampleSite/content/guides/202310-blowfish-tutorial/index.md Creates a .gitignore file to specify intentionally untracked files that Git should ignore. This example includes common exclusions for Node.js, OS-generated files, and Hugo build artifacts. ```bash #others node_modules .hugo_build.lock # OS generated files .DS_Store .DS_Store? ._* .Spotlight-V100 .Trashes # Hugo public ```