Skip to content

About

One World: personal blog and portfolio by dieghernan, with R tutorials, cartography, spatial data and open-source projects. Built with Jekyll and Chulapa.

Topics

Resources

Stars

16 stars

Watchers

1 watching

Forks

Repository files navigation

One World

R packages, spatial data, maps and open-source projects by dieghernan.

This repository contains the source of One World, my personal blog and portfolio. I share R tutorials, mapping experiments and the tools I build along the way.

The site runs on Jekyll with my Chulapa theme and is hosted on GitHub Pages.

Explore the site

  • Blog: R tutorials, package updates and experiments with geographic data.
  • Projects: R packages, datasets and other open-source work, including historical Pebble projects.
  • Gallery: Maps, plots and Wikimedia contributions.
  • About: A little about me and where to find my work.
  • Archive: Posts and projects ordered by date.

Featured packages include tidyterra, giscoR, mapSpain and geobounds for spatial data, cffr for software citation and resmush for image optimization.

Repository structure

Path Contents
index.md Home page.
_pages/ About, projects, gallery, archives and other site pages.
collections/_posts/ Published blog articles in Markdown.
collections/_projects/ Individual project pages.
_Rmd/ R Markdown sources for tutorials and mapping experiments.
_includes/ and _layouts/ Site customizations that extend Chulapa.
assets/ Styles, scripts and other static assets.
_config.yml Jekyll configuration and site settings.
llms.txt A curated guide to the site for language models.

Run locally

Use Ruby 3.4, as specified in .ruby-version, and Bundler. The Gemfile specifies Jekyll 4.4 and the site's plugins.

From the repository root:

bundle install
bundle exec jekyll serve

Open localhost:4000 to preview the site. Jekyll downloads the remote Chulapa theme during the build, so an internet connection is required.

To build without starting a server:

bundle exec jekyll build

The generated site is written to _site/, which is ignored by Git.

Deployment

The GitHub Actions workflows build the site and deploy it to GitHub Pages when changes are pushed to main or master. Deployment can also be started manually from the Actions tab.

The root llms.txt follows the llms.txt proposal. Jekyll copies it unchanged to /llms.txt, and the deployment workflows include it with the generated site. Update its selected links when the site structure or featured resources change.

Bridgy Fed

The blog uses its discoverable Atom and RSS feeds to publish through Bridgy Fed. The home page's representative h-card supplies the blog's display name, avatar, banner and bio. Keep its u-url pointing to the site's canonical home page. Edit indieweb_profile in _config.yml to update the name, nickname, bio, location, topics and profile links. The custom/h-card.html include renders the card outside the home page's h-entry so parsers can discover it directly.

The file .well-known/atproto-did contains the DID of the blog's bridged Bluesky account, not the author's personal account. Jekyll includes .well-known explicitly so the file is published without HTML layout. After deployment, check that https://dieghernan.github.io/.well-known/atproto-did returns only the DID, then complete the custom Bluesky handle change from the blog's Bridgy Fed user page. Publishing the file alone does not change the handle. Refresh the profile there after publishing changes to the h-card.

Keep feed-based publishing enabled: sending even one webmention to Bridgy Fed switches the site to webmention-based publishing and stops feed polling. The incoming webmention.io endpoint is separate and can remain enabled. Feed polling is asynchronous; the current Bridgy Fed implementation schedules checks between two hours and one day apart. A profile refresh does not import posts.

Syndicated copies of posts

When a post also exists on another service, add its actual public permalink (not a profile URL) to the post's frontmatter:

syndication:
  - https://social.example/@author/123456
  - https://bsky.app/profile/example.com/post/example

These are illustrative URLs, not existing copies of this site's posts. Replace them with the real permalinks before publishing. If the post has an equivalent .Rmd source, keep its frontmatter synchronized.

The default layout displays an “Also published on” list outside the article's e-content and inside its h-entry. Each link has u-syndication and rel="syndication", allowing IndieWeb readers to identify the copies. Only absolute HTTP(S) links with a hostname are rendered; no section appears when there are no usable links. No JavaScript, notifications or new service is required. This does not change Bridgy Fed's feed-based publishing.

License

This repository is distributed under the MIT license.

About

One World: personal blog and portfolio by dieghernan, with R tutorials, cartography, spatial data and open-source projects. Built with Jekyll and Chulapa.

Topics

Resources

Stars

16 stars

Watchers

1 watching

Forks

Sponsor this project

Used by

Contributors

Languages

Generated from dieghernan/chulapa-101