decksmith 0.1.14__tar.gz → 0.1.15__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: decksmith
3
- Version: 0.1.14
3
+ Version: 0.1.15
4
4
  Summary: A command-line application to dynamically generate decks of cards from a JSON specification and a CSV data file, inspired by nandeck.
5
5
  License-Expression: GPL-2.0-only
6
6
  Author: Julio Cabria
@@ -45,7 +45,7 @@ DeckSmith is ideal for automating the creation of all kinds of decks, including
45
45
  - ✨ Consistent layout and formatting across all cards. Define once, edit anytime, generate as many cards as you need.
46
46
  - 🍳 Pure python, with easy installation via pip.
47
47
  - ⚡ Highly performant card generation using parallel processing.
48
- - 📖 Intuitive syntax and extensive [documentation](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md) with examples to help you get started quickly.
48
+ - 📖 Intuitive syntax and extensive [documentation](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md) with examples to help you get started.
49
49
  - 🧰 Tons of powerful features such as:
50
50
  - [Start from a sample project and edit it instead of starting from scratch](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md#creating-a-project)
51
51
  - [Extensive support for images](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md#images), [text](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md#text), [and all kinds of different shapes](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md#shapes)
@@ -56,17 +56,45 @@ DeckSmith is ideal for automating the creation of all kinds of decks, including
56
56
 
57
57
  ## Getting started
58
58
 
59
- - First, install DeckSmith by running `pip install decksmith`.
59
+ ### Installation
60
60
 
61
- - Then, run `decksmith init` to start from sample `deck.json` and `deck.csv` files.
61
+ - To begin, install DeckSmith by running:
62
62
 
63
- - The `deck.json` file defines the layout for the cards in the deck, while the `deck.csv` file holds the data for each card.
63
+ ```bash
64
+ pip install decksmith
65
+ ```
64
66
 
65
- - You can find a complete list of all the available elements you can use in the [documentation](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md).
67
+ ### Creating a project
66
68
 
67
- - Any column from the CSV can be referenced anywhere in the JSON as `%column_name%`.
69
+ - Run the following command to start from sample `deck.json` and `deck.csv` files:
68
70
 
69
- - Finally, run `decksmith build` when you are ready to generate the deck images, and export them to PDF using the `decksmith export` command.
71
+ ```text
72
+ decksmith init
73
+ ```
74
+
75
+ - `deck.json` defines the layout for the cards in the deck.
76
+ - `deck.csv` holds the data for each card, like the content of the text fields and the image paths.
77
+
78
+ ### Defining the layout
79
+
80
+ - Edit `deck.json` to include all the elements you want on your cards.
81
+ You can find a complete list of all the available elements and their properties in the [documentation](https://github.com/Julynx/decksmith/blob/main/docs/DOCS.md).
82
+
83
+ - You can reference any column from `deck.csv` in the `deck.json` file as `%column_name%`.
84
+
85
+ ### Building the deck
86
+
87
+ - When you are ready to generate the deck images, run:
88
+
89
+ ```text
90
+ decksmith build
91
+ ```
92
+
93
+ - After building a deck, you can export it to PDF by running:
94
+
95
+ ```text
96
+ decksmith export
97
+ ```
70
98
 
71
99
  ## Documentation
72
100