Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Braindead is a braindead simple static site generator for minimalists, that has support for markdown and code highlighting.
Readme
Braindead is a braindead simple static site generator for minimalists, that has support for markdown and code highlighting. I created this package simply to have a bit of fun and because I'm tired of bloated software.
You can read more about the idea behind it on medium or my blog
Can't we just have simple software nowadays that does what it needs to do and nothing more? Existing solutions felt like they are too much for my needs. So I built this thing. It's still under active development.
Live example: grski.pl
One of my main ideals here is to create template that is as fast as it gets. Generated pages take around 10-15 KB in total. No JavaScript used here, at least in the base template. Just css/html.
You are free to change that though by creating your own templates. More on that below.
Benefits of simple approach:
Default template scores 100/100 on Google PageSpeed Insights and has very fast load times.
Default template design looks like this:
It's based on: Kiss template, slightly modified - with minimized styles. In the future I'll probably slim them down even more.
It's also eco friendly - it uses less power by not being a bloatware. CarbonReport of the demo
pip install braindead
Create index.md
and run braindead run
that's it. You'll find your generated site in dist
directory and the site being served at localhost:1644
.
To get more context/help and available commands run braindead
or braindead help
.
Known commands so far: run
, build
, serve
.
It can be empty or not - your choice. If you want index to contain just the posts - leave it empty.
That's the minimal setup you need. That'll generate index.html for you, but well, it's not enough, right? More robust structure you can use is:
pages/
page.md
posts/
post.md
index.md
pyproject.toml
The url for generated html will be {DIR_LOCATION}/{FILENAME}.html
,
so url generated will be {config.base_url}/{DIR_LOCATION}/{FILENAME}.html
in order to change that, add
Slug: custom-location
To your post/page header - then the location will be {BASE_URL}/{SLUG}.html
Title: Title of the post or of the page
Date: 2018-03-22
Authors: Olaf Górski
Description: Description of the post/page. If not provided it'll default to first 140 chars of the content.
CONTENT GOES HERE...
All of the metadata used here will be available during given page rendering. You can add more keys and metadata if you'd like.
All of the variables that are used to generate the page can be overwritten by creating pyproject.toml
file, but it's not required to get started.
Example of your pyproject
tool.braindead.site
section (these are also the defaults):
[tool.braindead.site]
base_url = "" # give full url ending with slash here - eg. if you host your blog on https://grski.pl/ enter it there.
author = "Olaf Górski" # author/owner of the site <- will be appended to the title
title = "Site generated with braindead" # base title of the website
description = "Just a description of site generated in braindead" # description used in the meta tags
content = "" # this will display under heading
name = "braindeadsite" # og tags
logo = "logo_url" # url to the logo for og tags
heading = "Braindead Example" # heading at the top of the site
github = "https://github.com/grski" # link to your github
linkedin = "https://linkedin.com/in/olafgorski" # link to your li
copy_text = "Olaf Górski" # copy text in the footer
copy_link = "https://grski.pl" # and copy link of the footer
language = "en" # default language set in the top level html lang property
just_titles = 0 # if set to 1 the index page will only display titles without descriptions on default template
None of these are required. You can overwrite none, one or more. Your choice.
Just do
```python Your code here ```
List of languages supported by pygments can be found here.
TODO
This bases on toml, markdown and jinja2.
Toml is used for configuration. Markdown to render all the .md and .markdows into proper html. Lastly jinja2 to add some contexts here and there.
Formatting of the code is done using black, isort. flake8, autoflake and bandit to check for potential vulns.
Versioning is done with bumpversion. Patch for merges to develop, minor for merged to master. Merge to master means release to pypi.
And wonderful poetry as dependency manager. BTW pipenv should die.
Code highligthing is done with pygments.
CLI is done with cleo
I use type hinting where it's possible.
To start developing you need to install poetry
pip install poetry==0.1.0
and then just poetry install
.
flake
isort
isort-inplace
bandit
black
linters
bumpversion
black-inplace
autoflake-inplace
format-inplace
Most important ones are make linters
and make format-inplace
. Before each commit it's required to run these checks.
MIT
FAQs
Braindead is a braindead simple static site generator for minimalists, that has support for markdown and code highlighting.
We found that braindead demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.