8 | Welcome to the archive of my monthly newsletter. Each edition offers a
9 | curated summary of the most important updates from my work and research.
10 |
11 | {% if newsletters %}
12 | No newsletters have been published yet.
23 | {% endif %}
24 | {% endblock %}
25 |
26 | {% block secondary %}{% endblock %}
27 |
--------------------------------------------------------------------------------
/blog/migrations/0009_import_ref.py:
--------------------------------------------------------------------------------
1 | from django.db import migrations, models
2 |
3 |
4 | class Migration(migrations.Migration):
5 | dependencies = [
6 | ("blog", "0008_entry_tweet_html"),
7 | ]
8 |
9 | operations = [
10 | migrations.AddField(
11 | model_name="blogmark",
12 | name="import_ref",
13 | field=models.TextField(max_length=64, null=True, unique=True),
14 | ),
15 | migrations.AddField(
16 | model_name="entry",
17 | name="import_ref",
18 | field=models.TextField(max_length=64, null=True, unique=True),
19 | ),
20 | migrations.AddField(
21 | model_name="quotation",
22 | name="import_ref",
23 | field=models.TextField(max_length=64, null=True, unique=True),
24 | ),
25 | ]
26 |
--------------------------------------------------------------------------------
/blog/migrations/0021_previous_tag_name.py:
--------------------------------------------------------------------------------
1 | from django.db import migrations, models
2 |
3 |
4 | class Migration(migrations.Migration):
5 |
6 | dependencies = [
7 | ("blog", "0020_tag_description"),
8 | ]
9 |
10 | operations = [
11 | migrations.CreateModel(
12 | name="PreviousTagName",
13 | fields=[
14 | (
15 | "id",
16 | models.AutoField(
17 | auto_created=True,
18 | primary_key=True,
19 | serialize=False,
20 | verbose_name="ID",
21 | ),
22 | ),
23 | ("previous_name", models.SlugField()),
24 | ("tag", models.ForeignKey(on_delete=models.CASCADE, to="blog.Tag")),
25 | ],
26 | ),
27 | ]
28 |
--------------------------------------------------------------------------------
/blog/context_processors.py:
--------------------------------------------------------------------------------
1 | from blog.models import Entry, Blogmark, Quotation, Note
2 | from django.conf import settings
3 | from django.core.cache import cache
4 |
5 |
6 | def all(request):
7 | return {
8 | "years_with_content": years_with_content(),
9 | }
10 |
11 |
12 | def years_with_content():
13 | cache_key = "years-with-content-3"
14 | years = cache.get(cache_key)
15 | if not years:
16 | years = list(
17 | set(
18 | list(Entry.objects.datetimes("created", "year"))
19 | + list(Blogmark.objects.datetimes("created", "year"))
20 | + list(Quotation.objects.datetimes("created", "year"))
21 | + list(Note.objects.datetimes("created", "year"))
22 | )
23 | )
24 | years.sort()
25 | cache.set(cache_key, years, 60 * 60)
26 | return years
27 |
--------------------------------------------------------------------------------
/monthly/views.py:
--------------------------------------------------------------------------------
1 | from django.http import Http404
2 | from django.shortcuts import render
3 |
4 | from .models import Newsletter
5 |
6 |
7 | def monthly_index(request):
8 | newsletters = Newsletter.objects.all()
9 | context = {
10 | "newsletters": newsletters,
11 | }
12 | return render(request, "monthly.html", context)
13 |
14 |
15 | def newsletter_detail(request, year, month):
16 | year = int(year)
17 | month = int(month)
18 | newsletters = Newsletter.objects.filter(
19 | sent_at__year=year, sent_at__month=month
20 | ).order_by("-sent_at")
21 | newsletter = newsletters.first()
22 | if newsletter is None:
23 | raise Http404("Newsletter not found")
24 |
25 | return render(
26 | request,
27 | "monthly_detail.html",
28 | {
29 | "newsletter": newsletter,
30 | },
31 | )
32 |
--------------------------------------------------------------------------------
/blog/migrations/0007_metadata_default.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 | # Generated by Django 1.11.5 on 2017-10-08 20:17
3 | from django.db import migrations, models
4 |
5 |
6 | class Migration(migrations.Migration):
7 | dependencies = [
8 | ("blog", "0006_gin_indexes"),
9 | ]
10 |
11 | operations = [
12 | migrations.AlterField(
13 | model_name="blogmark",
14 | name="metadata",
15 | field=models.JSONField(blank=True, default={}),
16 | ),
17 | migrations.AlterField(
18 | model_name="entry",
19 | name="metadata",
20 | field=models.JSONField(blank=True, default={}),
21 | ),
22 | migrations.AlterField(
23 | model_name="quotation",
24 | name="metadata",
25 | field=models.JSONField(blank=True, default={}),
26 | ),
27 | ]
28 |
--------------------------------------------------------------------------------
/blog/migrations/0023_blogmark_is_draft_entry_is_draft_quotation_is_draft.py:
--------------------------------------------------------------------------------
1 | # Generated by Django 5.1 on 2024-09-18 05:47
2 |
3 | from django.db import migrations, models
4 |
5 |
6 | class Migration(migrations.Migration):
7 |
8 | dependencies = [
9 | ("blog", "0022_alter_blogmark_use_markdown"),
10 | ]
11 |
12 | operations = [
13 | migrations.AddField(
14 | model_name="blogmark",
15 | name="is_draft",
16 | field=models.BooleanField(default=False),
17 | ),
18 | migrations.AddField(
19 | model_name="entry",
20 | name="is_draft",
21 | field=models.BooleanField(default=False),
22 | ),
23 | migrations.AddField(
24 | model_name="quotation",
25 | name="is_draft",
26 | field=models.BooleanField(default=False),
27 | ),
28 | ]
29 |
--------------------------------------------------------------------------------
/blog/migrations/0012_card_image.py:
--------------------------------------------------------------------------------
1 | # Generated by Django 2.1.2 on 2019-03-07 05:28
2 |
3 | from django.db import migrations, models
4 |
5 |
6 | class Migration(migrations.Migration):
7 | dependencies = [
8 | ("blog", "0011_entry_extra_head_html"),
9 | ]
10 |
11 | operations = [
12 | migrations.AddField(
13 | model_name="blogmark",
14 | name="card_image",
15 | field=models.CharField(blank=True, max_length=128, null=True),
16 | ),
17 | migrations.AddField(
18 | model_name="entry",
19 | name="card_image",
20 | field=models.CharField(blank=True, max_length=128, null=True),
21 | ),
22 | migrations.AddField(
23 | model_name="quotation",
24 | name="card_image",
25 | field=models.CharField(blank=True, max_length=128, null=True),
26 | ),
27 | ]
28 |
--------------------------------------------------------------------------------
/blog/factories.py:
--------------------------------------------------------------------------------
1 | import factory
2 | import factory.django
3 | import factory.fuzzy
4 | from datetime import timezone
5 |
6 |
7 | class BaseFactory(factory.django.DjangoModelFactory):
8 | slug = factory.Sequence(lambda n: "slug%d" % n)
9 | created = factory.Faker("past_datetime", tzinfo=timezone.utc)
10 |
11 |
12 | class EntryFactory(BaseFactory):
13 | class Meta:
14 | model = "blog.Entry"
15 |
16 | title = factory.Faker("sentence")
17 |
18 |
19 | class BlogmarkFactory(BaseFactory):
20 | class Meta:
21 | model = "blog.Blogmark"
22 |
23 | link_url = factory.Faker("uri")
24 | link_title = factory.Faker("sentence")
25 | commentary = factory.Faker("sentence")
26 |
27 |
28 | class QuotationFactory(BaseFactory):
29 | class Meta:
30 | model = "blog.Quotation"
31 |
32 |
33 | class NoteFactory(BaseFactory):
34 | class Meta:
35 | model = "blog.Note"
36 |
--------------------------------------------------------------------------------
/blog/migrations/0004_metadata_json.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 | # Generated by Django 1.11.5 on 2017-09-29 06:03
3 | from django.db import migrations, models
4 |
5 |
6 | class Migration(migrations.Migration):
7 | dependencies = [
8 | ("blog", "0003_auto_20170926_0641"),
9 | ]
10 |
11 | operations = [
12 | migrations.AddField(
13 | model_name="blogmark",
14 | name="metadata",
15 | field=models.JSONField(default={}),
16 | preserve_default=False,
17 | ),
18 | migrations.AddField(
19 | model_name="entry",
20 | name="metadata",
21 | field=models.JSONField(default={}),
22 | preserve_default=False,
23 | ),
24 | migrations.AddField(
25 | model_name="quotation",
26 | name="metadata",
27 | field=models.JSONField(default={}),
28 | preserve_default=False,
29 | ),
30 | ]
31 |
--------------------------------------------------------------------------------
/templates/admin/index.html:
--------------------------------------------------------------------------------
1 | {% extends "admin/index.html" %}
2 |
3 | {% block content %}
4 |
5 | {% include "admin/app_list.html" with app_list=app_list show_changelinks=True %}
6 |
7 |
Tools
8 |
9 |
10 | Bulk Tag Tool - Add tags to multiple items at once
11 |
12 |
13 | Merge Tags - Merge multiple tags into one
14 |
15 |
16 | SQL Dashboard - Run SQL queries against the database
17 |
18 |
19 |
20 |
"
91 | + str(tags.query)
92 | + ""
93 | )
94 |
95 | return JsonResponse({"tags": list(tags.values())})
96 |
--------------------------------------------------------------------------------
/static/lite-yt-embed.css:
--------------------------------------------------------------------------------
1 | lite-youtube {
2 | background-color: #000;
3 | position: relative;
4 | display: block;
5 | contain: content;
6 | background-position: center center;
7 | background-size: cover;
8 | cursor: pointer;
9 | max-width: 720px;
10 | }
11 |
12 | /* gradient */
13 | lite-youtube::before {
14 | content: attr(data-title);
15 | display: block;
16 | position: absolute;
17 | top: 0;
18 | /* Pixel-perfect port of YT's gradient PNG, using https://github.com/bluesmoon/pngtocss plus optimizations */
19 | background-image: linear-gradient(180deg, rgb(0 0 0 / 67%) 0%, rgb(0 0 0 / 54%) 14%, rgb(0 0 0 / 15%) 54%, rgb(0 0 0 / 5%) 72%, rgb(0 0 0 / 0%) 94%);
20 | height: 99px;
21 | width: 100%;
22 | font-family: "YouTube Noto",Roboto,Arial,Helvetica,sans-serif;
23 | color: hsl(0deg 0% 93.33%);
24 | text-shadow: 0 0 2px rgba(0,0,0,.5);
25 | font-size: 18px;
26 | padding: 25px 20px;
27 | overflow: hidden;
28 | white-space: nowrap;
29 | text-overflow: ellipsis;
30 | box-sizing: border-box;
31 | }
32 |
33 | lite-youtube:hover::before {
34 | color: white;
35 | }
36 |
37 | /* responsive iframe with a 16:9 aspect ratio
38 | thanks https://css-tricks.com/responsive-iframes/
39 | */
40 | lite-youtube::after {
41 | content: "";
42 | display: block;
43 | padding-bottom: calc(100% / (16 / 9));
44 | }
45 | lite-youtube > iframe {
46 | width: 100%;
47 | height: 100%;
48 | position: absolute;
49 | top: 0;
50 | left: 0;
51 | border: 0;
52 | }
53 |
54 | /* play button */
55 | lite-youtube > .lty-playbtn {
56 | display: block;
57 | /* Make the button element cover the whole area for a large hover/click target… */
58 | width: 100%;
59 | height: 100%;
60 | /* …but visually it's still the same size */
61 | background: no-repeat center/68px 48px;
62 | /* YT's actual play button svg */
63 | background-image: url('data:image/svg+xml;utf8,
17 | Atom feed for {{ tags.0 }}
18 |
19 |
20 |
28 |
29 |
36 | {{ total|intcomma }} post{{ total|pluralize }} tagged “{{ tags|join:"” and “" }}”
39 |
40 | {% if tag.description %}
41 | {{ tag.description_rendered }}
42 | {% endif %}
43 |
44 | {% if total > 10 %}
45 |
52 | {% endif %}
53 |
54 | {% load blog_tags %}
55 |
56 | {% blog_mixed_list_with_dates items year_headers=1 %}
57 |
58 | {% include "_pagination.html" %}
59 |
60 | {% endblock %}
61 |
62 | {% block secondary %}
63 |
75 | {% endblock %}
76 |
--------------------------------------------------------------------------------
/blog/management/commands/import_blog_json.py:
--------------------------------------------------------------------------------
1 | from django.core.management.base import BaseCommand
2 | from datetime import timezone
3 | from blog.models import (
4 | Entry,
5 | Blogmark,
6 | Tag,
7 | Quotation,
8 | )
9 | import requests
10 | from dateutil import parser
11 | import json
12 |
13 |
14 | class Command(BaseCommand):
15 | help = """
16 | ./manage.py import_blog_json URL-or-path-to-JSON
17 | """
18 |
19 | def add_arguments(self, parser):
20 | parser.add_argument(
21 | "url_or_path_to_json",
22 | type=str,
23 | help="URL or path to JSON to import",
24 | )
25 | parser.add_argument(
26 | "--tag_with",
27 | action="store",
28 | dest="tag_with",
29 | default=False,
30 | help="Tag to apply to all imported items",
31 | )
32 |
33 | def handle(self, *args, **kwargs):
34 | url_or_path_to_json = kwargs["url_or_path_to_json"]
35 | tag_with = kwargs["tag_with"]
36 | tag_with_tag = None
37 | if tag_with:
38 | tag_with_tag = Tag.objects.get_or_create(tag=tag_with)[0]
39 |
40 | is_url = url_or_path_to_json.startswith(
41 | "http://"
42 | ) or url_or_path_to_json.startswith("https://")
43 |
44 | if is_url:
45 | items = requests.get(url_or_path_to_json).json()
46 | else:
47 | items = json.load(open(url_or_path_to_json))
48 |
49 | for item in items:
50 | created = parser.parse(item["datetime"]).replace(tzinfo=timezone.utc)
51 | was_created = False
52 | slug = item["slug"][:64].strip("-")
53 | if item["type"] == "entry":
54 | klass = Entry
55 | kwargs = dict(
56 | body=item["body"],
57 | title=item["title"],
58 | created=created,
59 | slug=slug,
60 | metadata=item,
61 | )
62 | elif item["type"] == "quotation":
63 | klass = Quotation
64 | kwargs = dict(
65 | quotation=item["quotation"],
66 | source=item["source"],
67 | source_url=item["source_url"],
68 | created=created,
69 | slug=slug,
70 | metadata=item,
71 | )
72 | elif item["type"] == "blogmark":
73 | klass = Blogmark
74 | kwargs = dict(
75 | slug=slug,
76 | link_url=item["link_url"],
77 | link_title=item["link_title"],
78 | via_url=item.get("via_url") or "",
79 | via_title=item.get("via_title") or "",
80 | commentary=item["commentary"] or "",
81 | created=created,
82 | metadata=item,
83 | )
84 | else:
85 | assert False, "type should be known, %s" % item["type"]
86 | if item.get("import_ref"):
87 | obj, was_created = klass.objects.update_or_create(
88 | import_ref=item["import_ref"], defaults=kwargs
89 | )
90 | else:
91 | obj = klass.objects.create(**kwargs)
92 | tags = [Tag.objects.get_or_create(tag=tag)[0] for tag in item["tags"]]
93 | if tag_with_tag:
94 | tags.append(tag_with_tag)
95 | obj.tags.set(tags)
96 | print(was_created, obj, obj.get_absolute_url())
97 |
--------------------------------------------------------------------------------
/templates/entry.html:
--------------------------------------------------------------------------------
1 | {% extends "item_base.html" %}
2 | {% load entry_tags %}
3 | {% block title %}{{ entry.title|typography }}{% endblock %}
4 |
5 | {% block extrahead %}
6 | {{ block.super }}
7 | {{ entry.extra_head_html|default:""|safe }}
8 |
9 | {% endblock %}
10 |
11 | {% block card_title %}{{ entry.title|typography }}{% endblock %}
12 | {% block card_description %}{{ entry.body|xhtml|remove_context_paragraph|typography|xhtml2html|striptags|truncatewords:30|force_escape }}{% endblock %}
13 |
14 | {% block item_content %}
15 |
16 |
{{ entry.title|typography }}
17 |
{{ entry.created|date:"jS F Y" }}
18 |
19 | {% include "_draft_warning.html" %}
20 |
21 | {{ entry.body|xhtml|resize_images_to_fit_width:"450"|typography|xhtml2html }}
22 |
23 | {% if updates %}
24 |
25 | {% include "entry_updates.html" %}
26 |
27 | {% endif %}
28 |
31 | {% endblock %}
32 |
33 | {% block recent_articles_header %}More recent articles{% endblock %}
34 |
35 | {% block secondary %}
36 |
63 |
64 | {% if entry.tweet_html %}{{ entry.tweet_html|safe }}{% endif %}
65 | {% endblock %}
66 |
67 | {% block footer %}
68 | {% if previously_hosted %}Previously hosted at {{ previously_hosted }}
{% endif %}
69 | {{ block.super }}
70 | {% if entry.tweet_html %}{% endif %}
71 | {% endblock %}
72 |
--------------------------------------------------------------------------------
/blog/templatetags/tag_cloud.py:
--------------------------------------------------------------------------------
1 | from django import template
2 | from django.utils.safestring import mark_safe
3 |
4 | register = template.Library()
5 |
6 | from blog.models import Tag
7 |
8 | # Classes for different levels
9 | CLASSES = (
10 | "--skip--", # We don't show the least popular tags
11 | "not-popular-at-all",
12 | "not-very-popular",
13 | "somewhat-popular",
14 | "somewhat-more-popular",
15 | "popular",
16 | "more-than-just-popular",
17 | "very-popular",
18 | "ultra-popular",
19 | )
20 |
21 |
22 | def make_css_rules(
23 | min_size=0.7, max_size=2.0, units="em", selector_prefix=".tag-cloud ."
24 | ):
25 | num_classes = len(CLASSES)
26 | diff_each_time = (max_size - min_size) / (num_classes - 1)
27 | for i, klass in enumerate(CLASSES):
28 | print(
29 | "%s%s { font-size: %.2f%s; }"
30 | % (selector_prefix, klass, min_size + (i * diff_each_time), units)
31 | )
32 |
33 |
34 | import math
35 |
36 |
37 | def log(f):
38 | try:
39 | return math.log(f)
40 | except OverflowError:
41 | return 0
42 |
43 |
44 | @register.inclusion_tag("includes/tag_cloud.html")
45 | def tag_cloud_for_tags(tags):
46 | """
47 | Renders a tag cloud of tags. Input should be a non-de-duped list of tag
48 | strings.
49 | """
50 | return _tag_cloud_helper(tags)
51 |
52 |
53 | def _tag_cloud_helper(tags):
54 | # Count them all up
55 | tag_counts = {}
56 | for tag in tags:
57 | try:
58 | tag_counts[tag] += 1
59 | except KeyError:
60 | tag_counts[tag] = 1
61 | min_count = min(tag_counts.values())
62 | max_count = max(tag_counts.values())
63 | tags = list(tag_counts.keys())
64 | tags.sort()
65 | html_tags = []
66 | intervals = 10.0
67 | log_max = log(max_count)
68 | log_min = log(min_count)
69 | diff = log_max - log_min
70 | if diff < 0.01:
71 | # Avoid divide-by-zero problems
72 | diff = 0.01
73 | for tag in tags:
74 | score = tag_counts[tag]
75 | index = int((len(CLASSES) - 1) * (log(score) - log_min) / diff)
76 | if CLASSES[index] == "--skip--":
77 | continue
78 | html_tags.append(
79 | mark_safe(
80 | '%s %s '
81 | % (tag, score, (score != 1 and "s" or ""), CLASSES[index], tag, score)
82 | )
83 | )
84 | return {"tags": html_tags}
85 |
86 |
87 | @register.inclusion_tag("includes/tag_cloud.html")
88 | def tag_cloud():
89 | # We do this with raw SQL for efficiency
90 | from django.db import connection
91 |
92 | # Get tags for entries, blogmarks, quotations
93 | cursor = connection.cursor()
94 | cursor.execute(
95 | "select tag from blog_entry_tags, blog_tag where blog_entry_tags.tag_id = blog_tag.id"
96 | )
97 | entry_tags = [row[0] for row in cursor.fetchall()]
98 | cursor.execute(
99 | "select tag from blog_blogmark_tags, blog_tag where blog_blogmark_tags.tag_id = blog_tag.id"
100 | )
101 | blogmark_tags = [row[0] for row in cursor.fetchall()]
102 | cursor.execute(
103 | "select tag from blog_quotation_tags, blog_tag where blog_quotation_tags.tag_id = blog_tag.id"
104 | )
105 | quotation_tags = [row[0] for row in cursor.fetchall()]
106 | cursor.execute(
107 | "select tag from blog_note_tags, blog_tag where blog_note_tags.tag_id = blog_tag.id"
108 | )
109 | note_tags = [row[0] for row in cursor.fetchall()]
110 | cursor.close()
111 | # Add them together
112 | tags = entry_tags + blogmark_tags + quotation_tags + note_tags
113 | return _tag_cloud_helper(tags)
114 |
--------------------------------------------------------------------------------
/templates/includes/blog_mixed_list.html:
--------------------------------------------------------------------------------
1 | {% load entry_tags %}{% load humanize %}
2 | {% for item in items %}
3 | {% if year_headers %}{% ifchanged item.obj.created.year %}{{ item.obj.created.year }} {% endifchanged %}{% endif %}
4 | {% if day_headers %}{% ifchanged item.obj.created.date %}{% if day_links %}{{ item.obj.created.date }} {% else %}{{ item.obj.created.date }}{% endif %} {% endifchanged %}{% endif %}
5 | {% if item.type == "photoset" %}
6 |
7 |
8 |
9 | {% if item.obj.description %}
{{ item.obj.description }}
{% endif %}
10 |
{{ item.obj.primary.created|date:"f A"|lower }} / {{ item.obj.photos.count }} photo{{ item.obj.photos.count|pluralize }}{% if item.obj.has_map %} / map {% endif %}
11 |
12 |
16 |
17 | {% if item.obj.card_image %}
18 |
19 |
20 |
21 | {% endif %}
22 |
23 | {{ item.obj.body|split_cutoff|xhtml|remove_context_paragraph|first_paragraph|typography|xhtml2html }}
24 | {% if item.obj.multi_paragraph %}[... {{ item.obj.body|wordcount|intcomma }} word{{ item.obj.body|wordcount|pluralize }} ] {% endif %}
25 |
26 |
29 |
34 | #
35 | {% if showdate %}{{ item.obj.created|date:"jS F Y" }} ,
36 | {% endif %}{{ item.obj.created|date:"f A"|lower }}
37 | {% if all_tags %} / {% for tag in all_tags %}{{ tag.get_link }}{% if not forloop.last %}, {% endif %}{% endfor %}{% endif %}
38 |
39 | {% endpartialdef date-and-tags %}
40 | {% if item.type == "blogmark" %}
41 |
42 |
{{ item.obj.link_title|typography }} via ){% endif %}{% if not item.obj.via_url and not item.obj.link_title|ends_with_punctuation %}.{% endif %}
44 | {% if not item.obj.use_markdown %}{{ item.obj.commentary|typography|linebreaks|strip_wrapping_p }}{% else %}{{ item.obj.body|strip_wrapping_p }}{% endif %}
45 | {% partial date-and-tags %}
46 |
50 |
{{ item.obj.body }}
51 | — {% if item.obj.source_url %}{{ item.obj.source }} {% else %}{{ item.obj.source }}{% endif %}{% if item.obj.context %}, {{ item.obj.context_rendered }}{% endif %}
52 | {% partial date-and-tags %}
53 |
57 | {{ item.obj.body_rendered }}
58 | {% partial date-and-tags %}
59 |
60 | {% endif %}
61 | {% endwith %}
62 | {% endfor %}
63 |
--------------------------------------------------------------------------------
/templates/item_base.html:
--------------------------------------------------------------------------------
1 | {% extends "smallhead.html" %}
2 |
3 | {% block extrahead %}
4 |
20 | {% if show_comment_warning %}
21 |
22 | {% endif %}
23 | {% block item_content %}
24 | {% endblock %}
25 |
26 | {% if recent_articles %}
27 |
28 |
{% block recent_articles_header %}Recent articles{% endblock %}
29 |
30 | {% for article in recent_articles %}{% if article != item %}
31 | {{ article }} - {{ article.created|date:"jS F Y" }}
34 |
{{ comments|length }} comment{{ comments|length|pluralize }}
42 |
43 |
87 | {% endif %}
88 | {% endblock %}
89 |
--------------------------------------------------------------------------------
/templates/archive_year.html:
--------------------------------------------------------------------------------
1 | {% extends "smallhead.html" %}
2 |
3 | {% block title %}Archive for {{ year }}{% endblock %}
4 |
5 | {% block primary %}
6 | Archive for {{ year }}
7 |
8 |
9 |
10 | {% for month in months %}
11 | {{ month.date|date:"F" }}
14 | {% for entry in month.entries %}
15 | {{ entry.created|date:"jS" }}: {{ entry }}
16 | {% endfor %}
17 |
18 | {% endif %}
19 |
22 |
113 |
114 |
117 |
118 |
120 | `;
121 |
122 | this.setupImages();
123 |
124 | const dialog = this.shadowRoot.querySelector('dialog');
125 | dialog.addEventListener('click', (e) => {
126 | if (e.target === dialog) dialog.close();
127 | });
128 | }
129 |
130 | setupImages() {
131 | const slot = this.shadowRoot.querySelector('#gallery-slot');
132 | const images = slot.assignedElements();
133 |
134 | images.forEach(img => {
135 | if (img.tagName === 'IMG') {
136 | if (!img.dataset.fullsize) {
137 | img.dataset.fullsize = img.src;
138 | }
139 | if (img.dataset.thumb) {
140 | img.src = img.dataset.thumb;
141 | }
142 | img.onclick = (e) => this.handleImageClick(e);
143 | }
144 | });
145 | }
146 | }
147 |
148 | customElements.define('image-gallery', ImageGallery);
--------------------------------------------------------------------------------
/blog/management/commands/import_quora.py:
--------------------------------------------------------------------------------
1 | from django.core.management.base import BaseCommand
2 | from datetime import timezone
3 | from django.db import transaction
4 | from blog.models import (
5 | Entry,
6 | Tag,
7 | )
8 | from BeautifulSoup import BeautifulSoup as Soup
9 | import requests
10 | from django.utils.html import escape
11 | from django.utils.text import slugify
12 | from dateutil import parser
13 | import datetime
14 | import random
15 |
16 |
17 | class Command(BaseCommand):
18 | help = "./manage.py import_quora http://URL-to-JSON.json http://URL-to-topic-CSV"
19 |
20 | def add_arguments(self, parser):
21 | parser.add_argument("json_url", type=str)
22 | parser.add_argument("topic_csv_url", type=str)
23 |
24 | def handle(self, *args, **kwargs):
25 | data_url = kwargs["json_url"]
26 | topic_csv_url = kwargs["topic_csv_url"]
27 | lines = requests.get(topic_csv_url).content.split("\n")
28 | quora_to_tag = {
29 | line.split("\t")[0]: line.split("\t")[-1].strip()
30 | for line in lines
31 | if line.strip()
32 | }
33 | posts = requests.get(data_url).json()
34 | with transaction.atomic():
35 | quora = Tag.objects.get_or_create(tag="quora")[0]
36 | for post in posts:
37 | question = post["originalQuestion"] or post["question"]
38 | url = "https://www.quora.com" + (
39 | post["originalQuestionUrl"] or post["href"]
40 | )
41 | if question.endswith("Remove Banner"):
42 | question = question.replace("Remove Banner", "")
43 | answer = clean_answer(post["answer"])
44 | date = datetime.datetime.combine(
45 | parser.parse(post["meta"].replace("Added ", "")).date(),
46 | datetime.time(random.randint(9, 18), random.randint(0, 59)),
47 | ).replace(tzinfo=timezone.utc)
48 | truncated_question = question
49 | if len(truncated_question) > 250:
50 | truncated_question = truncated_question[:250] + "..."
51 | body = 'My answer to %s on Quora
' % (
52 | url,
53 | escape(question),
54 | )
55 | body += "\n\n" + answer
56 | body = body.replace(" ", " ")
57 | slug = slugify(" ".join(truncated_question.split()[:4]))
58 | with transaction.atomic():
59 | entry = Entry.objects.create(
60 | slug=slug,
61 | created=date,
62 | title=truncated_question,
63 | body=body,
64 | metadata=post,
65 | )
66 | entry.tags.add(quora)
67 | for topic in post["topics"]:
68 | tag = quora_to_tag.get(topic)
69 | if tag:
70 | entry.tags.add(Tag.objects.get_or_create(tag=tag)[0])
71 | print(entry)
72 |
73 |
74 | def clean_answer(html):
75 | soup = Soup(html)
76 | # Ditch class attributes
77 | for tag in ("p", "span", "a", "code", "div"):
78 | for el in soup.findAll(tag):
79 | del el["class"]
80 | # On links, kill the rel and target and onclick and tooltip
81 | for el in soup.findAll("a"):
82 | del el["rel"]
83 | del el["target"]
84 | del el["onclick"]
85 | del el["data-qt-tooltip"]
86 |
87 | for el in soup.findAll("canvas"):
88 | el.extract()
89 |
90 | for img in soup.findAll("img"):
91 | del img["class"]
92 | del img["data-src"]
93 | src = img["master_src"]
94 | del img["master_src"]
95 | w = img["master_w"]
96 | del img["master_w"]
97 | h = img["master_h"]
98 | del img["master_h"]
99 | img["src"] = src
100 | img["width"] = w
101 | img["height"] = h
102 | img["style"] = "max-width: 100%"
103 |
104 | # Cleanup YouTube videos
105 | for div in soup.findAll("div", {"data-video-provider": "youtube"}):
106 | iframe = Soup(div["data-embed"]).find("iframe")
107 | src = "https:%s" % iframe["src"].split("?")[0]
108 | div.replaceWith(
109 | Soup(
110 | """
111 |
114 | """
115 | % src
116 | )
117 | )
118 |
119 | html = str(soup)
120 | html = html.replace('%s
" % chunk
127 | new_chunks.append(chunk)
128 | return "\n\n".join(new_chunks)
129 |
--------------------------------------------------------------------------------
/blog/migrations/0001_initial.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 |
3 |
4 | from django.db import models, migrations
5 |
6 |
7 | class Migration(migrations.Migration):
8 | dependencies = []
9 |
10 | operations = [
11 | migrations.CreateModel(
12 | name="Blogmark",
13 | fields=[
14 | (
15 | "id",
16 | models.AutoField(
17 | verbose_name="ID",
18 | serialize=False,
19 | auto_created=True,
20 | primary_key=True,
21 | ),
22 | ),
23 | ("slug", models.SlugField(max_length=64)),
24 | ("link_url", models.URLField()),
25 | ("link_title", models.CharField(max_length=255)),
26 | ("via_url", models.URLField(null=True, blank=True)),
27 | ("via_title", models.CharField(max_length=255, null=True, blank=True)),
28 | ("commentary", models.TextField()),
29 | ("created", models.DateTimeField()),
30 | ],
31 | ),
32 | migrations.CreateModel(
33 | name="Entry",
34 | fields=[
35 | (
36 | "id",
37 | models.AutoField(
38 | verbose_name="ID",
39 | serialize=False,
40 | auto_created=True,
41 | primary_key=True,
42 | ),
43 | ),
44 | ("title", models.CharField(max_length=255)),
45 | ("slug", models.SlugField(max_length=64)),
46 | ("body", models.TextField()),
47 | ("created", models.DateTimeField()),
48 | ],
49 | ),
50 | migrations.CreateModel(
51 | name="Photo",
52 | fields=[
53 | (
54 | "id",
55 | models.AutoField(
56 | verbose_name="ID",
57 | serialize=False,
58 | auto_created=True,
59 | primary_key=True,
60 | ),
61 | ),
62 | ("flickr_id", models.CharField(max_length=32)),
63 | ("server", models.CharField(max_length=8)),
64 | ("secret", models.CharField(max_length=32)),
65 | ("title", models.CharField(max_length=255, null=True, blank=True)),
66 | ("longitude", models.CharField(max_length=32, null=True, blank=True)),
67 | ("latitude", models.CharField(max_length=32, null=True, blank=True)),
68 | ("created", models.DateTimeField()),
69 | ],
70 | ),
71 | migrations.CreateModel(
72 | name="Photoset",
73 | fields=[
74 | (
75 | "id",
76 | models.AutoField(
77 | verbose_name="ID",
78 | serialize=False,
79 | auto_created=True,
80 | primary_key=True,
81 | ),
82 | ),
83 | ("flickr_id", models.CharField(max_length=32)),
84 | ("title", models.CharField(max_length=255, null=True, blank=True)),
85 | ("description", models.TextField()),
86 | (
87 | "photos",
88 | models.ManyToManyField(related_name="in_photoset", to="blog.Photo"),
89 | ),
90 | (
91 | "primary",
92 | models.ForeignKey(to="blog.Photo", on_delete=models.CASCADE),
93 | ),
94 | ],
95 | ),
96 | migrations.CreateModel(
97 | name="Quotation",
98 | fields=[
99 | (
100 | "id",
101 | models.AutoField(
102 | verbose_name="ID",
103 | serialize=False,
104 | auto_created=True,
105 | primary_key=True,
106 | ),
107 | ),
108 | ("slug", models.SlugField(max_length=64)),
109 | ("quotation", models.TextField()),
110 | ("source", models.CharField(max_length=255)),
111 | ("source_url", models.URLField(null=True, blank=True)),
112 | ("created", models.DateTimeField()),
113 | ],
114 | ),
115 | migrations.CreateModel(
116 | name="Tag",
117 | fields=[
118 | (
119 | "id",
120 | models.AutoField(
121 | verbose_name="ID",
122 | serialize=False,
123 | auto_created=True,
124 | primary_key=True,
125 | ),
126 | ),
127 | ("tag", models.SlugField(unique=True)),
128 | ],
129 | ),
130 | migrations.AddField(
131 | model_name="quotation",
132 | name="tags",
133 | field=models.ManyToManyField(to="blog.Tag", blank=True),
134 | ),
135 | migrations.AddField(
136 | model_name="entry",
137 | name="tags",
138 | field=models.ManyToManyField(to="blog.Tag", blank=True),
139 | ),
140 | migrations.AddField(
141 | model_name="blogmark",
142 | name="tags",
143 | field=models.ManyToManyField(to="blog.Tag", blank=True),
144 | ),
145 | ]
146 |
--------------------------------------------------------------------------------
/templates/search.html:
--------------------------------------------------------------------------------
1 | {% extends "item_base.html" %}{% load humanize %}
2 |
3 | {% block title %}{{ title }}{% endblock %}
4 |
5 | {% block rel_canonical %}{% endblock %}
6 |
7 | {% block item_content %}
8 | {% load blog_tags %}
9 | {{ title }}
10 |
11 |
26 |
27 |
28 | {% if selected %}
29 | Filters:
30 | {% if selected.type %}
31 | Type: {{ selected.type }} ×
32 | {% endif %}
33 | {% if selected.year %}
34 | Year: {{ selected.year }} ×
35 | {% endif %}
36 | {% if selected.month %}
37 | Month: {{ selected.month_name }} ×
38 | {% endif %}
39 | {% for tag in selected.tags %}
40 | {{ tag }} ×
41 | {% endfor %}
42 | {% endif %}
43 | {% if results %}
44 | Sorted by {{ sort }} {% if q %} · {% endif %}
45 | {% if sort == "date" and q %}relevance {% endif %}
46 | {% if sort == "relevance" %}date {% endif %}
47 | {% endif %}
48 |
49 |
50 |
51 |
52 | {% if total %}
53 | {% if selected or q %}
54 | {% include "_pagination.html" with page_total=total %}
55 | {% blog_mixed_list_with_dates results %}
56 | {% include "_pagination.html" %}
57 | {% endif %}
58 | {% else %}
59 | {% if selected or q %}
60 | No results found
61 | {% if suggestion and num_corrected_results %}
62 | Suggestion: {{ suggestion }} ({{ num_corrected_results }} result{{ num_corrected_results|pluralize }})
63 | {% endif %}
64 | {% endif %}
65 | {% endif %}
66 |
67 | {% endblock %}
68 |
69 | {% block secondary %}
70 |
104 |
152 | {% endblock %}
153 |
--------------------------------------------------------------------------------
/blog/feeds.py:
--------------------------------------------------------------------------------
1 | from django.contrib.syndication.views import Feed
2 | from django.utils.dateformat import format as date_format
3 | from django.utils.feedgenerator import Atom1Feed
4 | from django.http import HttpResponse
5 | from blog.models import Entry, Blogmark, Quotation, Note
6 |
7 |
8 | class Base(Feed):
9 | feed_type = Atom1Feed
10 | link = "/"
11 | author_name = "Simon Willison"
12 |
13 | def __call__(self, request, *args, **kwargs):
14 | response = super(Base, self).__call__(request, *args, **kwargs)
15 | # Open CORS headers
16 | response["Access-Control-Allow-Origin"] = "*"
17 | response["Access-Control-Allow-Methods"] = "GET, OPTIONS"
18 | response["Access-Control-Max-Age"] = "1000"
19 | # Tell CloudFlare to cache my feeds
20 | cache_minutes = 10
21 | response["Cache-Control"] = "s-maxage=%d" % (cache_minutes * 60)
22 | return response
23 |
24 | def item_link(self, item):
25 | return (
26 | "https://simonwillison.net"
27 | + item.get_absolute_url()
28 | + "#atom-%s" % self.ga_source
29 | )
30 |
31 | def item_categories(self, item):
32 | return [t.tag for t in item.tags.all()]
33 |
34 | def item_pubdate(self, item):
35 | return item.created
36 |
37 | def item_updateddate(self, item):
38 | return item.created
39 |
40 | def get_feed(self, obj, request):
41 | feedgen = super().get_feed(obj, request)
42 | feedgen.content_type = "application/xml; charset=utf-8"
43 | return feedgen
44 |
45 |
46 | class Entries(Base):
47 | title = "Simon Willison's Weblog: Entries"
48 | ga_source = "entries"
49 |
50 | def items(self):
51 | return (
52 | Entry.objects.filter(is_draft=False)
53 | .prefetch_related("tags")
54 | .order_by("-created")[:15]
55 | )
56 |
57 | def item_title(self, item):
58 | return item.title
59 |
60 | def item_description(self, item):
61 | note = (
62 | "You are only seeing the long-form articles from my blog. "
63 | 'Subscribe to /atom/everything/ '
64 | 'to get all of my posts, or take a look at my other subscription options .
'
65 | )
66 | return item.body + note
67 |
68 |
69 | class Blogmarks(Base):
70 | title = "Simon Willison's Weblog: Blogmarks"
71 | description_template = "feeds/blogmark.html"
72 | ga_source = "blogmarks"
73 |
74 | def items(self):
75 | return (
76 | Blogmark.objects.filter(is_draft=False)
77 | .prefetch_related("tags")
78 | .order_by("-created")[:15]
79 | )
80 |
81 | def item_title(self, item):
82 | return item.title or item.link_title
83 |
84 |
85 | class Everything(Base):
86 | title = "Simon Willison's Weblog"
87 | description_template = "feeds/everything.html"
88 | ga_source = "everything"
89 |
90 | def items(self):
91 | # Pretty dumb implementation: pull top 30 of entries/blogmarks/quotations
92 | # then sort them together and return most recent 30 combined
93 | last_30_entries = list(
94 | Entry.objects.filter(is_draft=False)
95 | .prefetch_related("tags")
96 | .order_by("-created")[:30]
97 | )
98 | last_30_blogmarks = list(
99 | Blogmark.objects.filter(is_draft=False)
100 | .prefetch_related("tags")
101 | .order_by("-created")[:30]
102 | )
103 | last_30_quotations = list(
104 | Quotation.objects.filter(is_draft=False)
105 | .prefetch_related("tags")
106 | .order_by("-created")[:30]
107 | )
108 | last_30_notes = list(
109 | Note.objects.filter(is_draft=False)
110 | .prefetch_related("tags")
111 | .order_by("-created")[:30]
112 | )
113 | combined = (
114 | last_30_blogmarks + last_30_entries + last_30_quotations + last_30_notes
115 | )
116 | combined.sort(key=lambda e: e.created, reverse=True)
117 | return combined[:30]
118 |
119 | def item_title(self, item):
120 | if isinstance(item, Entry):
121 | return item.title
122 | elif isinstance(item, Blogmark):
123 | return item.title or item.link_title
124 | elif isinstance(item, Quotation):
125 | return "Quoting %s" % item.source
126 | elif isinstance(item, Note):
127 | if item.title:
128 | return item.title
129 | else:
130 | return "Note on {}".format(date_format(item.created, "jS F Y"))
131 | else:
132 | return "Unknown item type"
133 |
134 |
135 | class SeriesFeed(Everything):
136 | ga_source = "series"
137 |
138 | def __init__(self, series):
139 | self.title = "Simon Willison's Weblog: {}".format(series.title)
140 | self.series = series
141 |
142 | def items(self):
143 | return list(self.series.entry_set.all().order_by("-created"))
144 |
145 |
146 | class EverythingTagged(Everything):
147 | ga_source = "tag"
148 |
149 | def __init__(self, title, items):
150 | self.title = "Simon Willison's Weblog: {}".format(title)
151 | self._items = items
152 |
153 | def items(self):
154 | return self._items
155 |
156 |
157 | def sitemap(request):
158 | xml = [
159 | ''
160 | ''
161 | ]
162 | for klass in (Entry, Blogmark, Quotation, Note):
163 | for obj in klass.objects.exclude(is_draft=True).only("slug", "created"):
164 | xml.append(
165 | "https://simonwillison.net%s ")
169 | return HttpResponse("\n".join(xml), content_type="application/xml")
170 |
--------------------------------------------------------------------------------
/templates/about.html:
--------------------------------------------------------------------------------
1 | {% extends "item_base.html" %}
2 |
3 | {% block title %}About Simon Willison{% endblock %}
4 |
5 | {% block rel_canonical %}{% endblock %}
6 |
7 | {% block item_content %}{% load blog_tags %}
8 |
9 |
About me
10 |
11 |
Here's my most recent conference bio:
12 |
13 |
14 | Simon Willison is the creator of Datasette , an open source tool for exploring and publishing data. He currently works full-time building open source tools for data journalism, built around Datasette and SQLite.
15 |
16 | Prior to becoming an independent open source developer, Simon was an engineering director at Eventbrite. Simon joined Eventbrite through their acquisition of Lanyrd, a Y Combinator funded company he co-founded in 2010.
17 |
18 | He is a co-creator of the Django Web Framework, and has been blogging about web development and programming since 2002 at simonwillison.net
19 |
20 |
21 |
Subscribe
22 |
23 |
You can subscribe to my blog via email newsletter, using Atom feeds or by following me on Mastodon or Bluesky or Twitter.
24 |
25 |
Free weekly-ish newsletter
26 |
27 |
I send out a newsletter version of this blog once every week or so. You can subscribe to that here:
28 |
29 |
30 |
31 |
Paid monthly newsletter
32 |
33 |
I write a lot of stuff. If you like you can pay me to send you less . At the end of every month I send out a much shorter newsletter to anyone who sponsors me for $10 or more on GitHub . It's intended to be a ten minute read that catches you up on the most important developments from the past month in LLMs and my other projects and research.
34 |
35 |
Mastodon and Bluesky and Twitter
36 |
37 |
42 |
43 |
Atom feeds
44 |
45 |
The main feed for my site combines my blog entries, my blogmarks and my collected quotations:
46 |
47 |
https://simonwillison.net/atom/everything/
48 |
49 |
If you just want my longer form blog entries you can subscribe to this feed instead:
50 |
51 |
https://simonwillison.net/atom/entries/
52 |
53 |
Or this feed for just my links (excluding quotes):
54 |
55 |
https://simonwillison.net/atom/links/
56 |
57 |
Every tag on my blog has its own feed. You can subscribe to those by adding .atom to the URL to the tag page.
58 |
59 |
For example, to subscribe to just my content about Datasette, use the following:
60 |
61 |
https://simonwillison.net/tags/datasette.atom
62 |
63 |
Disclosures
64 |
65 | {% filter markdownify %}
66 | I do not receive any compensation for writing about specific topics on this blog - no sponsored content! I plan to continue this policy. If I ever change this I will disclose that both here and in the post itself.
67 |
68 | Part of work on [Datasette Cloud](https://www.datasette.cloud/) is sponsored by [Fly.io](https://fly.io/). I have a generous set of [GitHub Sponsors](https://github.com/sponsors/simonw) who support my work on Datasette and other open source projects.
69 |
70 | I am currently a member of the board of directors [for the Python Software Foundation](https://www.python.org/psf/board/).
71 |
72 | I am a [GitHub Star](https://stars.github.com/profiles/simonw/) (an unpaid position). GitHub paid me as a participant of their [GitHub Accelerator](https://github.blog/news-insights/company-news/github-accelerator-our-first-cohort-and-whats-next/) program in 2023.
73 |
74 | Mozilla supported my work as part of [their MIECO program](https://web.archive.org/web/20240917063820/https://future.mozilla.org/mieco2023/) (Internet Ecosystem program) in 2023-2024.
75 |
76 | I have not accepted payments from LLM vendors, but I am frequently invited to preview new LLM products and features from organizations that include OpenAI, Anthropic, Gemini and Mistral, often under NDA or subject to an embargo. This often also includes free API credits and invitations to events.
77 |
78 | *One exception: OpenAI paid my for my time when I attended a GPT-5 preview at their office which was [used in a video](https://simonwillison.net/2025/Aug/7/previewing-gpt-5/). They did not ask for any editorial insight or control over what I wrote after that event, aside from keeping to their embargo.*
79 |
80 | I run ads on my blog using [EthicalAds](https://www.ethicalads.io/). I also earn money from Twitter's [Creator Revenue Sharing](https://help.x.com/en/using-x/creator-revenue-sharing) program, and try not to let that incentivize me to post engagement bait!
81 |
82 | I provide ad-hoc consulting and training services to a number of different companies and organizations. If any of those represent a conflict of interest with my writing here I will disclose that in the relevant post.
83 |
84 | {% endfilter %}
85 |
86 |
About this site
87 |
88 |
This site is a custom web application built using Django . The source code can be found on GitHub at simonw/simonwillisonblog .
89 |
The site is hosted on Heroku and stores content in PostgreSQL, which is backed up to JSON files in simonw/simonwillisonblog-backup . These are then deployed to a Datasette instance running at datasette.simonwillison.net .
90 |
18 |
19 |
20 |
21 |
28 |
29 |
30 |
31 |
32 | 1
33 | message
34 | auth
35 | message
36 |
37 |
38 |
39 | 2
40 | group
41 | auth
42 | group
43 |
44 |
45 |
46 | 3
47 | user
48 | auth
49 | user
50 |
51 |
52 |
53 | 4
54 | permission
55 | auth
56 | permission
57 |
58 |
59 |
60 | 5
61 | content type
62 | contenttypes
63 | contenttype
64 |
65 |
66 |
67 | 6
68 | session
69 | sessions
70 | session
71 |
72 |
73 |
74 | 7
75 | site
76 | sites
77 | site
78 |
79 |
80 |
81 | 8
82 | log entry
83 | admin
84 | logentry
85 |
86 |
87 |
88 | 9
89 | topic
90 | speaking
91 | topic
92 |
93 |
94 |
95 | 10
96 | material
97 | speaking
98 | material
99 |
100 |
101 |
102 | 11
103 | event
104 | speaking
105 | event
106 |
107 |
108 |
109 | 12
110 | talk
111 | speaking
112 | talk
113 |
114 |
115 |
116 | 13
117 | comment
118 | blog
119 | comment
120 |
121 |
122 |
123 | 14
124 | previous revision
125 | blog
126 | previousrevision
127 |
128 |
129 |
130 | 15
131 | photo
132 | blog
133 | photo
134 |
135 |
136 |
137 | 16
138 | blacklisted domain
139 | blog
140 | blacklisteddomain
141 |
142 |
143 |
144 | 17
145 | blogmark
146 | blog
147 | blogmark
148 |
149 |
150 |
151 | 18
152 | tag
153 | blog
154 | tag
155 |
156 |
157 |
158 | 19
159 | entry
160 | blog
161 | entry
162 |
163 |
164 |
165 | 20
166 | photoset
167 | blog
168 | photoset
169 |
170 |
171 |
172 | 21
173 | quotation
174 | blog
175 | quotation
176 |
177 |
178 |
179 | 22
180 | nonce
181 | openidconsumer
182 | nonce
183 |
184 |
185 |
186 | 23
187 | association
188 | openidconsumer
189 | association
190 |
191 |
192 |
193 | 24
194 | watch
195 | blog
196 | watch
197 |
198 |
199 |
200 | 25
201 | whitelist
202 | blog
203 | whitelist
204 |
205 |
206 |
207 | 26
208 | url
209 | shorter
210 | url
211 |
212 |
213 |
214 |
215 |
216 |
217 |
--------------------------------------------------------------------------------
/blog/templatetags/blog_calendar.py:
--------------------------------------------------------------------------------
1 | from django import template
2 |
3 | register = template.Library()
4 |
5 | from blog.models import Entry, Photo, Quotation, Blogmark, Photoset, Note
6 | import datetime, copy
7 |
8 | # This code used to use the following:
9 | # import calendar
10 | # calendar.Calendar().itermonthdates(date.year, date.month)
11 | # But... that functionality of the calendar module is only available in
12 | # 2.5, and relies on the with statement. D'oh!
13 |
14 | FIRSTWEEKDAY = 0 # Monday
15 |
16 |
17 | def itermonthdates(year, month):
18 | "Modelled after 2.5's calendar...itermonthdates"
19 | date = datetime.date(year, month, 1)
20 | # Go back to the beginning of the week
21 | days = (date.weekday() - FIRSTWEEKDAY) % 7
22 | date -= datetime.timedelta(days=days)
23 | oneday = datetime.timedelta(days=1)
24 | while True:
25 | yield date
26 | date += oneday
27 | if date.month != month and date.weekday() == FIRSTWEEKDAY:
28 | break
29 |
30 |
31 | def get_next_month(date):
32 | "I can't believe this isn't in the standard library!"
33 | if date.month == 12:
34 | return datetime.date(date.year + 1, 1, 1)
35 | else:
36 | return datetime.date(date.year, date.month + 1, 1)
37 |
38 |
39 | def get_previous_month(date):
40 | if date.month == 1:
41 | return datetime.date(date.year - 1, 12, 1)
42 | else:
43 | return datetime.date(date.year, date.month - 1, 1)
44 |
45 |
46 | @register.inclusion_tag("includes/calendar.html")
47 | def render_calendar(date):
48 | return calendar_context(date)
49 |
50 |
51 | @register.inclusion_tag("includes/calendar.html")
52 | def render_calendar_month_only(date):
53 | ctxt = calendar_context(date)
54 | ctxt["month_only"] = True
55 | return ctxt
56 |
57 |
58 | MODELS_TO_CHECK = ( # Name, model, score
59 | ("links", Blogmark, 2, "created"),
60 | ("entries", Entry, 4, "created"),
61 | ("quotes", Quotation, 2, "created"),
62 | ("notes", Note, 2, "created"),
63 | ("photos", Photo, 1, "created"),
64 | ("photosets", Photoset, 2, "primary__created"),
65 | )
66 |
67 |
68 | def make_empty_day_dict(date):
69 | d = dict([(key, []) for key, _1, _2, _3 in MODELS_TO_CHECK])
70 | d.update({"day": date, "populated": False, "display": True})
71 | return d
72 |
73 |
74 | def attribute_lookup(obj, attr_string):
75 | "Attr string is something like 'primary__created"
76 | lookups = attr_string.split("__")
77 | for lookup in lookups:
78 | obj = getattr(obj, lookup)
79 | return obj
80 |
81 |
82 | def calendar_context(date):
83 | "Renders a summary calendar for the given month"
84 | day_things = dict(
85 | [(d, make_empty_day_dict(d)) for d in itermonthdates(date.year, date.month)]
86 | )
87 | # Flag all days NOT in year/month as display: False
88 | for day in list(day_things.keys()):
89 | if day.month != date.month:
90 | day_things[day]["display"] = False
91 | for name, model, score, created_lookup in MODELS_TO_CHECK:
92 | lookup_args = {
93 | created_lookup + "__month": date.month,
94 | created_lookup + "__year": date.year,
95 | }
96 | if model in (Blogmark, Entry, Quotation, Note):
97 | lookup_args["is_draft"] = False
98 | for item in model.objects.filter(**lookup_args):
99 | day = day_things[attribute_lookup(item, created_lookup).date()]
100 | day[name].append(item)
101 | day["populated"] = True
102 | # Now that we've gathered the data we can render the calendar
103 | days = list(day_things.values())
104 | days.sort(key=lambda x: x["day"])
105 | # But first, swoop through and add a description to every day
106 | for day in days:
107 | day["score"] = score_for_day(day)
108 | if day["populated"]:
109 | day["description"] = description_for_day(day)
110 | if day["day"] == date:
111 | day["is_this_day"] = True
112 | # Now swoop through again, applying a colour to every day based on score
113 | cg = ColourGradient(WHITE, PURPLE)
114 | max_score = max([d["score"] for d in days] + [0.001])
115 | for day in days:
116 | day["colour"] = cg.pick_css(float(day["score"]) / max_score)
117 | weeks = []
118 | while days:
119 | weeks.append(days[0:7])
120 | del days[0:7]
121 | # Find next and previous months
122 | # WARNING: This makes an assumption that I posted at least one thing every
123 | # month since I started.
124 | first_month = Entry.objects.all().order_by("created")[0].created.date()
125 | if get_next_month(first_month) <= date:
126 | previous_month = get_previous_month(date)
127 | else:
128 | previous_month = None
129 | if date < datetime.date.today().replace(day=1):
130 | next_month = get_next_month(date)
131 | else:
132 | next_month = None
133 | return {
134 | "next_month": next_month,
135 | "previous_month": previous_month,
136 | "date": date,
137 | "weeks": weeks,
138 | }
139 |
140 |
141 | PURPLE = (163, 143, 183)
142 | WHITE = (255, 255, 255)
143 |
144 |
145 | class ColourGradient(object):
146 | def __init__(self, min_col, max_col):
147 | self.min_col = min_col
148 | self.max_col = max_col
149 |
150 | def pick(self, f):
151 | f = float(f)
152 | assert 0.0 <= f <= 1.0, "argument must be between 0 and 1, inclusive"
153 |
154 | def calc(pair):
155 | return (pair[0] - pair[1]) * f + pair[1]
156 |
157 | return tuple(map(calc, list(zip(self.max_col, self.min_col))))
158 |
159 | def pick_css(self, f):
160 | "Returns e.g. rgb(0, 0, 0)"
161 | return "rgb(%s)" % ", ".join(map(str, list(map(int, self.pick(f)))))
162 |
163 |
164 | def description_for_day(day):
165 | bits = []
166 | for key in day:
167 | if isinstance(day[key], list) and len(day[key]) > 0:
168 | count = len(day[key])
169 | if count == 1:
170 | name = day[key][0]._meta.verbose_name
171 | else:
172 | name = day[key][0]._meta.verbose_name_plural
173 | bits.append("%d %s" % (count, name))
174 | return ", ".join(bits)
175 |
176 |
177 | def score_for_day(day):
178 | "1 point/photo, 2 points for blogmark/quote/photoset, 4 points for entry"
179 | score = 0
180 | for name, model, points, created_lookup in MODELS_TO_CHECK:
181 | score += points * len(day[name])
182 | return score
183 |
--------------------------------------------------------------------------------
/templates/base.html:
--------------------------------------------------------------------------------
1 | {% load static %}
2 |
3 |
4 | {% block title %}{% endblock %}
8 |
9 |
26 | {% block body %}{% endblock %}
27 |
28 | {% block footer %}
29 |
30 |
31 | Colophon © {% for year in years_with_content %}
33 | {{ year|date:"Y" }}
35 |
36 |
37 |
43 |
44 |
45 |