scientific-python / blog.scientific-python.org Goto Github PK

Removed in f2fe7aa

In scientific-python/scientific-python-hugo-theme#279 it was requested that the paginator visibility is better, especially on mobile.

Ensure that remnant CSS classes are either used/removed.

@jarrodmillman pointed out some issues with the "tag cloud" on https://blog.scientific-python.org/posts/.

Here are some issues I've noted as well:

• The readability and clickability of some items is poor
• The size of tags is inconsistent, some being very small (like 3d) and some very long (like traveling-salesman-problem). This is hard to make aesthetically pleasing, as well as being inconsistent for usability and readability.

Some ideas:

• Limit the range of font sizes: smaller tags would be larger, and larger ones would be smaller, resulting in a more even appearance.
• Unify the font sizes completely: every tag would be the same size. The information currently conveyed (the size representing how many posts exist with the tag) could be conveyed by other means, like a number next to the tag.
• Have a separate page for the tag cloud: giving it more space would allow more freedom to display them in useful, creative ways.
• Dispense with the tag cloud entirely: they seem somewhat popular, but whether they're useful to readers is another matter.

@jarrodmillman @stefanv What do you think? Also, who else should we tag for feedback on these ideas? Thanks.

    socialmedia:
      - link: https://scientific-python.org
        icon: fa-solid fa-house

should be this icon

• https://github.com/scientific-python/scientific-python-archive/blob/main/branding/logo/scientific-python-logo-bw-dark.svg

Hi, was wondering if the tags can be moved/hidden on mobile, cause they make the blog really hard to navigate.

It would be great to be able to get a "bird's eye view" of all the blog posts ever made. Instead of paginating to 5 or 10, we can paginate to a hundred, and make the post list much more condensed (e.g., by removing the abstracts).

https://blog.scientific-python.org/posts/

Compare this

to this

The spacing is different and maybe the font (e.g., the fi is completely different).

This is a super minor feature, but it'd be nice (IMO) to allow post tags to have spaces, e.g. "traveling salesman problem". The current problem with this is that the tag is directly translated to a URL, so the spaces result in an invalid address. Perhaps this feature would be as easy as adding something along the lines of {{ tag.replace(" ", "-") }} in one the template/partial for the /tags page?

Not a big deal, just a potential tiny improvement. The current behavior is also fine so long as authors know their tags should contain only URL-safe characters.

While reviewing #81 I came across the very nice blog post by Arseny Khakhalin on visualizing all graphs (in the network sense) with a certain number of nodes. When looking this over, I noticed it was very similar to the graph atlas from the networkx example gallery, so I thought it might be nice to add a cross-link to some of the NetworkX functionality that is related to the topic of the post.

However, I was unsure about what the policy is for non-authors making content modifications to others' blog posts. Certain modifications (grammar/formatting fixups, adding alt-text, etc.) should be uncontroversial as they don't really modify the content of the post. However, the posts have an author tag at the top which shows who wrote the original post. If someone other than the original author were to modify a post, then the author tag can make it seem like the modifier is putting words in the original author's mouth! Given this, I was wondering if there was a policy re: blog-post modification by non-authors.

• date on on line
• how to handle code in summary (maybe require a short sentence summary as a field, maybe no summary)

See Posts > > ....

After #184, we have the following error:

[jarrod@x111 src]$ git clone [email protected]:scientific-python/blog.scientific-python.org.git
Cloning into 'blog.scientific-python.org'...
remote: Enumerating objects: 1496, done.
remote: Counting objects: 100% (402/402), done.
remote: Compressing objects: 100% (190/190), done.
remote: Total 1496 (delta 202), reused 312 (delta 179), pack-reused 1094
Receiving objects: 100% (1496/1496), 30.37 MiB | 16.96 MiB/s, done.
Resolving deltas: 100% (617/617), done.
[jarrod@x111 src]$ cd blog.scientific-python.org/
[jarrod@x111 blog.scientific-python.org (main)]$ make serve 
git submodule update --init
Submodule 'themes/scientific-python-hugo-theme' (https://github.com/scientific-python/scientific-python-hugo-theme) registered for path 'themes/scientific-python-hugo-theme'
Cloning into '/home/jarrod/src/blog.scientific-python.org/themes/scientific-python-hugo-theme'...
Submodule path 'themes/scientific-python-hugo-theme': checked out 'd5d755cb5a69a8d2bf76e6b66abe819b210c9751'
pre-commit install || echo "Install 'pre-commit' in a Python environment with: 'pip install pre-commit'"
pre-commit installed at .git/hooks/pre-commit
hugo version || echo "Install Hugo from: https://gohugo.io"
hugo v0.123.0-3c8a4713908e48e6523f058ca126710397aa4ed5+extended linux/amd64 BuildDate=2024-02-19T16:32:38Z VendorInfo=snap:0.123.0
<...>
Error: command error: failed to load modules: module "hugo-atom-feed" not found in "/home/jarrod/src/blog.scientific-python.org/themes/hugo-atom-feed"; either add it as a Hugo Module or store it in "/home/jarrod/src/blog.scientific-python.org/themes".: module does not exist
make: *** [Makefile:39: serve] Error 1

Currently the urls for the blog posts look something like:

https://blog.scientific-python.org/posts/scipy/internships/smit/

It would be nice if the project directory (i.e. posts/scipy/ in the above) contained an index/listing of project-specific blog-posts.

Adding comments will allow us to publish slightly more controversial opinion pieces, since the community will then be able to add different perspectives.

Consider public hosted tools such as (update list as you find options):

• https://github.com/giscus/giscus
• https://github.com/utterance/utterances (not sure it's being maintained?

See also https://gohugo.io/content-management/comments/

In #44, I added a simple tag cloud. This should be improved.

• interface for selecting multiple tags at once and clearing them
• maybe the cloud tag should also be on individual posts and on tag pages

When using the random state for parallel processing, do we need the private API?

From my understanding, we can use the public API:

import numpy as np
from joblib import Parallel, delayed


def stochastic_function(high=10, rng=None):
    if not isinstance(rng, np.random.Generator):
        rng = np.random.default_rng(rng)
    return rng.integers(high, size=5)


seed = 319929794527176038403653493598663843656
rng = np.random.default_rng(seed)
child_states = rng.spawn(5)

random_vector = Parallel(n_jobs=2)(
    delayed(stochastic_function)(rng=random_state) for random_state in child_states
)
print(random_vector)

random_vector = Parallel(n_jobs=2)(
    delayed(stochastic_function)(rng=random_state) for random_state in child_states
)
print(random_vector)

CC @albertcthomas

It might be nice to add a spell checker to the CI/lint checks.

Some/most alt texts are missing or not providing useful information.