841 sao GitHub và vẫn tăng — minimaxir/stylecloud là dự án đa ngôn ngữ mà TopGit đang theo dõi trên nền tảng.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Generate stylistic wordclouds, including gradients and icon shapes!
stylecloud is a Python package that leverages the popular word_cloud package, adding useful features to create truly unique word clouds!
Icon shapes (of any size!) for wordclouds (via Font Awesome 5.13.0 Free, or your own Font Awesome Pro)
Support for advanced color palettes (via palettable)
Manual color selection for text and backgrounds,
Directional gradients w/ the aforementioned palettes.
Supports reading text files and CSVs (either one-column w/ texts, or two columns w/ words+weights).
Command Line Interface!
This package is a more formal implementation of my stylistic word cloud project from 2016.
Installation
You can install stylecloud via pip:
pip3 install stylecloud
Usage
You can use stylecloud in a Python script or as a standalone CLI app. For example, let's say you have a text of the U.S. Constitution constitution.txt.
But you can do so much more! You can use the free Font Awesome icons to change the shape, change the color palette to one from palettable for a custom style, change the background color, and, most importantly, add a gradient so the colors flow in a specified direction!
You can find more examples of styleclouds, including how to make styleclouds from Twitter and Reddit data, in the stylecloud-examples repo.
Custom Colors for stylecloud Text
You can manually specify the color(s) of the text with the colors parameter, overriding the palettes. This can be useful for specific branding, or high-contrast visualizations. However, manual color selection will not work with gradients.
stylecloud --file_path constitution.txt --custom_stopwords "[thereof, may, state, united states]"
Good resources for stopwords in other languages are the stop-words Python package and the ISO stopword collections.
Helpful Parameters
These parameters are valid for both the Python function and the CLI (you can use stylecloud -h to get this information as well).
text: Input text. Best used if calling the function directly.
file_path: File path of the input text/CSV. Best used on the CLI.
gradient: Direction of gradient. (if not None, the stylecloud will use a directional gradient) [default: None]
size: Size (length and width in pixels) of the stylecloud, or a two-element tuple representing the width and height of the stylecloud (e.g. '(1024, 512)' for a 1024x512 stylecloud). [default: 512]
icon_name: Icon Name for the stylecloud shape. (e.g. 'fas fa-grin') [default: fas fa-flag]
palette: Color palette (via palettable) [default: cartocolors.qualitative.Bold_5]
colors: Color(s) to use as the text colors. Overrides both gradient and palette if specified [default: None]
background_color: Background color (name or hex) [default: white]
max_font_size: Maximum font size in the stylecloud. [default: 200]
max_words: Maximum number of words to include in the stylecloud. [default: 2000]
stopwords: Boolean to filter out common stopwords. [default: True]
custom_stopwords: list of custom stopwords. e.g: For other languages than english [default: STOPWORDS, via word_cloud]
output_name: Output file name of the stylecloud. [default: stylecloud.png]
font_path: Path to .ttf file for font to use in stylecloud. [default: uses included Staatliches font]
random_state: Controls random state of words and colors. [default: None]
collocations: Whether to include collocations (bigrams) of two words. Same behavior as base word_cloud package. [default: True]
invert_mask: Whether to invert the icon mask, so the words fill the space except the icon mask. [default: False]
pro_icon_path: Path to Font Awesome Pro .ttf file if using FA Pro. [default: None]
pro_css_path: Path to Font Awesome Pro .css file if using FA Pro. [default: None]
Helpful Notes
The primary goal of this package is to create data visualizations of text that provide a unique aesthetic. Word clouds have tradeoffs in terms of a statistically robust data visualization, but this is explicitly prioritizing coolness!
This package is released as a separate package from word_cloud due to the increase in scope and Python dependencies.
The ideal fonts for generating a good stylecloud are a) bold/high weight in order to increase readability, and b) condensed/low kerning to fit more text. Both of these traits are why Staatliches is the default font for stylecloud (overriding Droid Sans in the base word_cloud).
You may want to consider doing post-processing after generating a stylecloud: for example, adding color masks, adding perception skew, feed it to a style transfer AI model, etc.
The default max_font_size of 200 is calibrated for the default size of 512. If you increase the size, you may want to consider increasing max_font_size as well.
Due to the size of the included Font Awesome font files, they will not be updated on every new minor FA release.
It's recommended to use FA icons which are large with heavy weight; thin icons might constrain the text too much.
If using the default random-color-sampling method, it's recommended to use a qualitative palette. Inversely, if using a gradient, it's recommended to use a nonqualitative palette (e.g. a sequential palette).
Projects Using stylecloud
twcloud — Python package + CLI to generate wordclouds of Twitter tweets.
Maintainer/Creator
Max Woolf (@minimaxir)
Max's open-source projects are supported by his Patreon and GitHub Sponsors. If you found this project helpful, any monetary contributions to the Patreon are appreciated and will be put to good creative use.
License
MIT
Font Awesome icon font files included per the terms in its SIL OFL 1.1 License.
Staatliches font included per the terms in its SIL OFL 1.1 License.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/minimaxir/stylecloud là nguồn chính thức.
minimaxir/stylecloud có bao nhiêu sao?
minimaxir/stylecloud có 841 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/minimaxir/stylecloud. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
minimaxir/stylecloud có tag gì không?
Bản đồng bộ chưa ghi nhận topic GitHub nào cho minimaxir/stylecloud. GitHub topics hiển thị ở thanh bên phải trang repo — đó là nơi đáng kiểm tra nhất.
minimaxir/stylecloud có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho minimaxir/stylecloud. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
minimaxir/stylecloud còn được duy trì không?
TopGit chưa ghi nhận lần push gần đây của minimaxir/stylecloud. Xem lịch sử commit trực tiếp trên GitHub để biết thông tin chính xác nhất.
minimaxir/stylecloud viết bằng ngôn ngữ gì?
Dữ liệu TopGit chưa ghi nhận ngôn ngữ chính cho minimaxir/stylecloud. Xem danh sách file trên GitHub để biết chi tiết.
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về stylecloud?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về stylecloud.