svgblock 0.1.0

• 🧭 How a Block Is Built
• 🚀 How to Use
• 🧱 Building a Block
  • Creating a block
  • Adding content
  • Text markers
  • Columns
  • Tables
  • Images
  • Saving the result
  • Animations
• 🛠️ Customization
  • Creating your own theme
  • Constants reference
• 🎨 Themes
  • 1. Dark Colors
  • 2. Light Colors (Pastels)
  • 3. Seasons
  • 4. Drinks
  • 5. Countries & Geography
  • 6. Aesthetics & Culture
  • 7. Classical UI (Dev Themes)
  • 8. Mythology & Concepts
• 🩺 Troubleshooting

⬆ back to top

python --version
pip install git+https://github.com/JonatasCortes/svgblock.git

# or clone the repository and install it from the folder
git clone https://github.com/JonatasCortes/svgblock.git
cd svgblock
pip install .

from svgblock import Block

(
    Block(theme="neon", width=900, animation="slide-up")
    .title("Hello, I'm Bob")
    .text("I build **small tools** in **pure Python** and I love open source.")
    .subsection("What I am learning")
    .text("Right now I am studying **graph algorithms** and **computer vision**.")
    .save("assets/block.svg")
)

python generate_blocks.py

<p align="center">
  <img src="assets/block.svg" alt="About me" width="900">
</p>

from svgblock import Block

Block(theme="dracula", animation="fade").title("About me").text("...").save("assets/about.svg")
Block(theme="nord", animation="pop").title("Projects").text("...").save("assets/projects.svg")

⬆ back to top

Block(theme="red", width=900, animation="fade")

(
    Block(theme="coffee")
    .title("Projects")
    .text("A few things I built.", font_size=18)
    .subsection("HNSW Character Recognition")
    .text("Train and test your own model.")
    .divider()
    .table(["Project", "Stars"], [["HNSW", 120], ["Voronoi Stats", 85]])
    .image("assets/preview.png", width=300)
    .divider(0.5)
    .title("Contact")
    .text("Find me on GitHub.")
)

.text("**ola __mundo__** ola, --errado-- e ##inclinado##")
.text(r"A literal \*\* needs a backslash before each asterisk.")

from svgblock import Block, Column

(
    Block(theme="nord")
    .columns(
        Column(1).subsection("Weight 1").text("A narrow column, good for short notes."),
        Column(2).subsection("Weight 2").text("A column twice as wide, ideal for the main text."),
    )
)

.table(
    ["Language", "Level", "Typed"],
    [
        ["Python", "**Advanced**", True],
        ["Rust", "##Learning##", True],
        ["COBOL", "--Retired--", None],
    ],
    align=("left", "center", "center"),
    weights=(2, 2, 1),
    striped=True,
    row_dividers=True,
    column_dividers=False,
)

(
    Block(theme="mocha")
    .columns(
        Column(1).image("assets/logo.png", width=110),
        Column(4).subsection("A logo beside the text").text("The text takes the rest of the width."),
    )
)

from svgblock import Animation, Block

# No animation (the default)
Block()

# Plays once
Block(animation="pop")
Block(animation=Animation.SLIDE_UP)

# Replays every 5 seconds
Block(animation="slide-up", animation_loop=5)

⬆ back to top

"mytheme": {
    "background_center": "#1B2B34", "background_edge": "#0B1014",
    "border_start": "#6699CC", "border_end": "#223344",
    "title_text": "#99C794", "title_bar": "#99C794",
    "subsection_text": "#FAC863", "subsection_marker": "#FAC863",
    "text": "#D8DEE9", "highlight": "#FFFFFF",
    "underline": "#6699CC", "strikethrough": "#65737E", "italic": "#C0C5CE",
    "table_background": "#10181D", "table_header_background": "#223540",
    "table_header_text": "#99C794", "table_text": "#D8DEE9",
    "table_divider": "#33505F", "table_stripe_background": "#15222A",
    "table_border": "#33505F", "divider": "#6699CC",
},

git clone https://github.com/JonatasCortes/svgblock.git
cd svgblock
pip install -e .

⬆ back to top

⬆ back to top

⬆ back to top