obsidian-plugin/sophokles187_data-cards
1
0
Fork 0
mirror of https://github.com/sophokles187/data-cards.git synced 2026-07-22 12:30:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
sophokles187_data-cards/docs/getting-started.md
Marius 324052a5c8 docs
2025-03-29 04:19:10 +01:00

2.9 KiB
Raw Blame History

Getting Started with DataCards

Table of contents

Installation

Requirements

Installation Methods

Method 1: Community Plugins

Note

: DataCards is not yet available in the Community Plugins store. Please use BRAT or manual installation until then.

  1. Open Obsidian Settings
  2. Go to Community Plugins
  3. Click "Browse" and search for "Data Cards"
  4. Click "Install", then "Enable"

Method 2: BRAT Plugin

  1. Install the BRAT plugin through Community Plugins
  2. Open BRAT settings in Obsidian
  3. Click "Add Beta Plugin"
  4. Enter the DataCards repository URL: https://github.com/Sophokles187/data-cards
  5. Click "Add Plugin"
  6. Enable DataCards in Community Plugins settings

Method 3: Manual Installation

  1. Download the latest release from the releases page
  2. Download these files:
    • main.js
    • manifest.json
    • style.css
  3. Navigate to your Obsidian vault's .obsidian/plugins/ directory
  4. Create a new folder named data-cards
  5. Copy the downloaded files into the data-cards folder
  6. Enable the plugin in Obsidian's Community Plugins settings

Basic Usage

Create a datacards code block with a Dataview query:

TABLE author, rating, genre FROM #books
SORT rating DESC

This will automatically render the results as cards using the default settings.

Your First DataCards Block

  1. Make sure both Dataview and DataCards plugins are enabled
  2. Create a new note or open an existing one
  3. Start a new code block with three backticks followed by datacards
  4. Write a Dataview query
  5. End the code block with three backticks
  6. Preview your note to see the cards

That's it! Your Dataview results will now display as beautiful cards.

Customizing Cards

You can customize your cards by adding settings after your query:

TABLE author, rating, genre, cover FROM #books
SORT rating DESC

// Settings
preset: portrait
imageProperty: cover

Settings are added after your query, following a line with // Settings. Each setting is specified as key: value on a new line.

Settings Reference

For a complete list of all available settings and their options, refer to the Settings Reference page.

This reference includes:

  • All available settings with descriptions
  • Default values
  • Available options for each setting
  • Example usages

You can access this reference at any time to find the exact setting you need.