Skip to content

Commit ce4d94a

Browse files
authored
Merge pull request #4 from nok/docs
Update docs
2 parents 56ef96e + 4e0cea3 commit ce4d94a

File tree

5 files changed

+80
-108
lines changed

5 files changed

+80
-108
lines changed

README.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="/assets/pandas-render.png" alt="pandas-render" height=130>
2+
<img src="https://raw.githubusercontent.com/nok/pandas-render/refs/heads/main/assets/pandas-render.png" alt="pandas-render" height=130>
33
</p>
44

55
<h1 align="center">pandas-render</h1>
@@ -10,19 +10,18 @@
1010

1111
![GitHub Repo stars](https://img.shields.io/github/stars/nok/pandas-render)
1212
[![Ko-fi](https://img.shields.io/badge/Ko--fi-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/nok)
13-
[![GitHub License](https://img.shields.io/github/license/nok/sklearn-porter)](LICENSE)
1413

1514
</div>
1615

1716

1817
## Installation
1918

2019
```bash
21-
pip install pandas-render[pandas]
20+
pip install "pandas-render[pandas]"
2221
```
2322

2423
```bash
25-
pip install pandas-render[polars]
24+
pip install "pandas-render[polars]"
2625
```
2726

2827

@@ -65,6 +64,11 @@ List of all notebooks with examples:
6564
- [Components](examples/02_components.ipynb)
6665

6766

67+
## Support
68+
69+
Do you like this project? Fuel it with a ☕ coffee on [Ko-fi](https://ko-fi.com/nok). Every little bit helps and means a lot!
70+
71+
6872
## Contributing
6973

7074
We encourage you to contribute to this project! Please check out the [contributing guidelines](CONTRIBUTING.md) about how to proceed.

examples/01_getting_started.ipynb

Lines changed: 43 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,11 @@
22
"cells": [
33
{
44
"cell_type": "markdown",
5-
"id": "3b1e5b84",
5+
"id": "c5f44e87",
66
"metadata": {},
77
"source": [
88
"# pandas-render\n",
99
"\n",
10-
"[pandas-render](https://github.com/nok/pandas-render) is a [pandas](https://github.com/pandas-dev/pandas) extension for rendering DataFrames and Series as HTML tables, with support for custom styling and formatting.\n",
11-
"\n",
12-
"Installation:\n",
13-
"\n",
14-
"```bash\n",
15-
"pip install pandas-render\n",
16-
"```\n",
17-
"\n",
1810
"## Getting Started\n",
1911
"\n",
2012
"This example shows how to use pandas-render to create a simple HTML table from a pandas DataFrame. It demonstrates how to use Jinja2 templates to format the content of each cell, and how to create links and images in the table.\n",
@@ -26,13 +18,13 @@
2618
{
2719
"cell_type": "code",
2820
"execution_count": 1,
29-
"id": "80111e60",
21+
"id": "16298615",
3022
"metadata": {
3123
"execution": {
32-
"iopub.execute_input": "2025-04-09T23:15:05.636164Z",
33-
"iopub.status.busy": "2025-04-09T23:15:05.635773Z",
34-
"iopub.status.idle": "2025-04-09T23:15:05.887448Z",
35-
"shell.execute_reply": "2025-04-09T23:15:05.887060Z"
24+
"iopub.execute_input": "2025-04-18T08:29:30.293505Z",
25+
"iopub.status.busy": "2025-04-18T08:29:30.293403Z",
26+
"iopub.status.idle": "2025-04-18T08:29:30.540217Z",
27+
"shell.execute_reply": "2025-04-18T08:29:30.539905Z"
3628
}
3729
},
3830
"outputs": [],
@@ -42,7 +34,7 @@
4234
},
4335
{
4436
"cell_type": "markdown",
45-
"id": "f8aade2f",
37+
"id": "ad381e0c",
4638
"metadata": {},
4739
"source": [
4840
"Or import it implicitly after importing pandas:\n",
@@ -55,7 +47,7 @@
5547
},
5648
{
5749
"cell_type": "markdown",
58-
"id": "71961e92",
50+
"id": "0d715aa4",
5951
"metadata": {},
6052
"source": [
6153
"### Data\n",
@@ -65,13 +57,13 @@
6557
{
6658
"cell_type": "code",
6759
"execution_count": 2,
68-
"id": "e9c3dbaa",
60+
"id": "f633cab9",
6961
"metadata": {
7062
"execution": {
71-
"iopub.execute_input": "2025-04-09T23:15:05.889445Z",
72-
"iopub.status.busy": "2025-04-09T23:15:05.889287Z",
73-
"iopub.status.idle": "2025-04-09T23:15:05.892493Z",
74-
"shell.execute_reply": "2025-04-09T23:15:05.892125Z"
63+
"iopub.execute_input": "2025-04-18T08:29:30.542200Z",
64+
"iopub.status.busy": "2025-04-18T08:29:30.542036Z",
65+
"iopub.status.idle": "2025-04-18T08:29:30.545306Z",
66+
"shell.execute_reply": "2025-04-18T08:29:30.545014Z"
7567
}
7668
},
7769
"outputs": [],
@@ -108,7 +100,7 @@
108100
},
109101
{
110102
"cell_type": "markdown",
111-
"id": "d76c7c78",
103+
"id": "f2856816",
112104
"metadata": {},
113105
"source": [
114106
"Here is the original rendering of the DataFrame. It's a simple table with no formatting or styling. It's not very readable, and the data is not very visually appealing."
@@ -117,13 +109,13 @@
117109
{
118110
"cell_type": "code",
119111
"execution_count": 3,
120-
"id": "da750110",
112+
"id": "f2396934",
121113
"metadata": {
122114
"execution": {
123-
"iopub.execute_input": "2025-04-09T23:15:05.893902Z",
124-
"iopub.status.busy": "2025-04-09T23:15:05.893802Z",
125-
"iopub.status.idle": "2025-04-09T23:15:05.900891Z",
126-
"shell.execute_reply": "2025-04-09T23:15:05.900647Z"
115+
"iopub.execute_input": "2025-04-18T08:29:30.546734Z",
116+
"iopub.status.busy": "2025-04-18T08:29:30.546637Z",
117+
"iopub.status.idle": "2025-04-18T08:29:30.555636Z",
118+
"shell.execute_reply": "2025-04-18T08:29:30.555380Z"
127119
}
128120
},
129121
"outputs": [
@@ -216,7 +208,7 @@
216208
},
217209
{
218210
"cell_type": "markdown",
219-
"id": "2ce9de38",
211+
"id": "43dcf205",
220212
"metadata": {},
221213
"source": [
222214
"### Rendering\n",
@@ -226,13 +218,13 @@
226218
{
227219
"cell_type": "code",
228220
"execution_count": 4,
229-
"id": "ddf0a87a",
221+
"id": "351b70e6",
230222
"metadata": {
231223
"execution": {
232-
"iopub.execute_input": "2025-04-09T23:15:05.902207Z",
233-
"iopub.status.busy": "2025-04-09T23:15:05.902096Z",
234-
"iopub.status.idle": "2025-04-09T23:15:05.909596Z",
235-
"shell.execute_reply": "2025-04-09T23:15:05.909299Z"
224+
"iopub.execute_input": "2025-04-18T08:29:30.557067Z",
225+
"iopub.status.busy": "2025-04-18T08:29:30.556928Z",
226+
"iopub.status.idle": "2025-04-18T08:29:30.564057Z",
227+
"shell.execute_reply": "2025-04-18T08:29:30.563756Z"
236228
}
237229
},
238230
"outputs": [
@@ -267,7 +259,7 @@
267259
},
268260
{
269261
"cell_type": "markdown",
270-
"id": "5ef2c3ac",
262+
"id": "5c9cc573",
271263
"metadata": {},
272264
"source": [
273265
"### Filtering and Ordering\n",
@@ -277,13 +269,13 @@
277269
{
278270
"cell_type": "code",
279271
"execution_count": 5,
280-
"id": "db762efb",
272+
"id": "0f4f02db",
281273
"metadata": {
282274
"execution": {
283-
"iopub.execute_input": "2025-04-09T23:15:05.910954Z",
284-
"iopub.status.busy": "2025-04-09T23:15:05.910857Z",
285-
"iopub.status.idle": "2025-04-09T23:15:05.915410Z",
286-
"shell.execute_reply": "2025-04-09T23:15:05.915146Z"
275+
"iopub.execute_input": "2025-04-18T08:29:30.565390Z",
276+
"iopub.status.busy": "2025-04-18T08:29:30.565294Z",
277+
"iopub.status.idle": "2025-04-18T08:29:30.569915Z",
278+
"shell.execute_reply": "2025-04-18T08:29:30.569630Z"
287279
},
288280
"lines_to_next_cell": 2
289281
},
@@ -317,7 +309,7 @@
317309
},
318310
{
319311
"cell_type": "markdown",
320-
"id": "9edda3ec",
312+
"id": "b33b7b0f",
321313
"metadata": {},
322314
"source": [
323315
"### Dynamic Placeholder\n",
@@ -328,13 +320,13 @@
328320
{
329321
"cell_type": "code",
330322
"execution_count": 6,
331-
"id": "e37324a3",
323+
"id": "74b26e4a",
332324
"metadata": {
333325
"execution": {
334-
"iopub.execute_input": "2025-04-09T23:15:05.916698Z",
335-
"iopub.status.busy": "2025-04-09T23:15:05.916602Z",
336-
"iopub.status.idle": "2025-04-09T23:15:05.922364Z",
337-
"shell.execute_reply": "2025-04-09T23:15:05.922104Z"
326+
"iopub.execute_input": "2025-04-18T08:29:30.571157Z",
327+
"iopub.status.busy": "2025-04-18T08:29:30.571063Z",
328+
"iopub.status.idle": "2025-04-18T08:29:30.577175Z",
329+
"shell.execute_reply": "2025-04-18T08:29:30.576889Z"
338330
}
339331
},
340332
"outputs": [
@@ -415,7 +407,7 @@
415407
},
416408
{
417409
"cell_type": "markdown",
418-
"id": "80974ebd",
410+
"id": "171615fe",
419411
"metadata": {},
420412
"source": [
421413
"### Gallery\n",
@@ -425,13 +417,13 @@
425417
{
426418
"cell_type": "code",
427419
"execution_count": 7,
428-
"id": "4dc6eb5f",
420+
"id": "34d09fdd",
429421
"metadata": {
430422
"execution": {
431-
"iopub.execute_input": "2025-04-09T23:15:05.923691Z",
432-
"iopub.status.busy": "2025-04-09T23:15:05.923606Z",
433-
"iopub.status.idle": "2025-04-09T23:15:05.927855Z",
434-
"shell.execute_reply": "2025-04-09T23:15:05.927566Z"
423+
"iopub.execute_input": "2025-04-18T08:29:30.578645Z",
424+
"iopub.status.busy": "2025-04-18T08:29:30.578521Z",
425+
"iopub.status.idle": "2025-04-18T08:29:30.582906Z",
426+
"shell.execute_reply": "2025-04-18T08:29:30.582620Z"
435427
}
436428
},
437429
"outputs": [

examples/01_getting_started.py

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,6 @@
11
# %% [markdown]
22
# # pandas-render
33
#
4-
# [pandas-render](https://github.com/nok/pandas-render) is a [pandas](https://github.com/pandas-dev/pandas) extension for rendering DataFrames and Series as HTML tables, with support for custom styling and formatting.
5-
#
6-
# Installation:
7-
#
8-
# ```bash
9-
# pip install pandas-render
10-
# ```
11-
#
124
# ## Getting Started
135
#
146
# This example shows how to use pandas-render to create a simple HTML table from a pandas DataFrame. It demonstrates how to use Jinja2 templates to format the content of each cell, and how to create links and images in the table.

0 commit comments

Comments
 (0)