Coeur is being made based on Typer (Thanks @tiangolo).
"cœur" is a French word for "core" or "heart".
This tool is called Coeur for two personal reasons: 1. it will be the core of my blog-farm; 2. one of my favorite places is the Sacre Cœur in Paris.
I'm bringing Coeur to the world to solve some specific problems that I'm dealing with when trying to manage big blogs as static sites. By big, I mean more than 100.000 post files.
Imagine the following scenario: You have a set of blogs with a lot of content, they can be within WordPress or any tool of this kind. The more content and traffic your blog has, the more you'll need to worry about your infrastructure.
Some time ago, I migrated my blog projects to SSG, which means only static content generated with the contents, and I can keep all of them hosted for free using GitHub Pages or Netlify.
The problem is that the SSG tools available today are not optimized for this amount of content, and with artificial intelligence, it is very practical to generate quality content on a large scale.
So, Coeur will solve this. It will be a tool that will allow me to build larger blogs and continue to maintain them for free, allowing me to explore other content niches and generate more and more content for my users.
This tool is being built based on several years of experience I have with creating blogs/sites using various tools, including WordPress, VuePress, VitePress, Zola, and probably some others that were less relevant in my tests.
If I were to summarize Coeur in a single sentence, considering the end of the project where we will have all modules ready and not just the SSG, I would say:
The complete tool for building blogs with over a million posts and hosting them for free.
Coeur is a common python package, you can install from pypi:
pip install --user blog-coeur
The command to be used is blog-coeur and get help to start to use:
blog-coeur --help
The first module of coeur is the ssg to be possible to build a complete static website from a sqlite database and also the base feature to import from markdown to database.
To start your project, you can run the create command with your new project name, this command will to create the new folder with the basic stuff to work:
blog-coeur ssg create my-blog
To build the blog we need some local server to simplify or life, you can run this command inside of coeur project to use a simple locally server:
blog-coeur ssg server --max-posts=1000 --port=8081
The param max-posts will be useful when you post has some much posts, this way the build will be more fast in development time.
To build your blog, you can run the build command inside the blog directory:
blog-coeur ssg build
The blog will be generated inside the directory "public".
If you are using the Zola Framework and want to migrate to Coeur, you can import your markdown files into the Coeur database.
Considering that you are inside the Coeur Blog repository, copy the posts directory here and run the command replacing "./content" for your posts directory.
blog-coeur ssg markdown-to-db "./content"
The CMP module was designed to simplify content creation powered by the OpenAI API.
The content will be created as posts inside the blog's SQLite database, which is generated by the ssg module. It's important to start your project using the ssg command.
Assuming you already have the blog created with Coeur, you need to setting up your open-ai key in the .env file and then you can use the cmp module as follows:
blog-coeur cmp title-to-post "Aguas de Lindóia" --custom-prompt="Create a full article about the city, need to be funny and talking in positive way about the place"
The first parameter is required and will be the title of the post.
It is highly recommended to use a custom-prompt to enhance your experience and get better results. This prompt can be in any language.
You can also set the img-url parameter to include an image in the post. This needs to be a valid image URL, such as one hosted on S3.
This module will help us to automatically publish the blog posts in the social midias.
My initial goal was to be able to build my project without exploding my RAM memory as happened with all the frameworks I tried and used throughout the growth of my blog, these benchmark numbers below are the real numbers for the same blog that consumes 12GB to be built with Zola.
It is possible that I can optimize the build time to make it faster, however, it will consume a little more RAM memory. For now it's acceptable.
Importing 103594 posts from Zola markdowns from command blog-coeur ssg markdown-to-db ./content:
Processed: 103594 | Duration: 00:02:11.162591
Debug: RSS: 934.58 MB | VMS: 957.69 MB | Data: 925.75 MB | USS: 922.11 MB | PSS: 923.16 MB | CPU: 71.00%
This is the final debug line, spending around 934.58 MB to do all importation in 02 minutes.
Remembering that you need do it only one time.
The current build is taking 05 minutes and consuming around 362 MB of RSS, with the minify=false:
Processed: 103594 | Duration: 00:05:19.639324
Debug: RSS: 362.93 MB | VMS: 629.91 MB | Data: 388.62 MB | USS: 350.16 MB | PSS: 351.26 MB | Processed: 103594 | CPU: 99.40%
This is an open-source project, and I need help to make it better.
If you are a developer, feel free to contact me to work on items from my personal roadmap, or you can suggest something new. Be free, let's do it together.
If you are a company, contact me to support the growth of my project. I'm open to improve it for specifics new use-cases.
FAQs
Coeur - static site management
We found that blog-coeur 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
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.