#dev 2021-12-07
2021-12-07 UTC
KartikPrabhu and gRegor joined the channel
KartikPrabhu joined the channel
# 
capjamesg[d] [snarfed] Have you been trying to send webmentions from localhost? I just got a webmention from this URL: http://localhost/2021-09-13_my-new-social-pages-james-coffee-blog and notice the slug matched one on your site.
# capjamesg[d] It's no big deal because the mention does not validate anyway.
angelo joined the channel
# 
jamietanna[m] Sorry snarfed not right now. Kinda hoping to move over to https://github.com/barryf/vibrancy/ before long, but not yet taken the plunge
kogepan joined the channel
tetov-irc, digivonity and iama_hooman[d] joined the channel
# capjamesg My reservation is that the utilities have quite different functions. But grouping them together makes sense because some are too small for a module on their own (i.e. URL canonicalization) and many functions pair well with each other (auth callback verification and endpoint discovery, for example).
# 
[snarfed] relevant example: https://pypi.org/project/mf2util/
# capjamesg[d] [snarfed] and/or [tantek] Would you have a moment to review a README?
# capjamesg[d] It's 1,300 words long.
Seb[d] joined the channel
# capjamesg I have just invited you to this private repo: https://github.com/capjamesg/python-indieweb-utils
alex11 joined the channel
# [snarfed] the per-method and other code-specific docs are better left to your actual docs, which are often auto-generated from docstrings, etc. easier to keep those up to date when they live with the code itself. (also dependencies, leave those to your setup.py or requirements.txt unless they're unusual)
[fluffy] joined the channel
# capjamesg[d] [snarfed] It looks like I'll need to write some docstrings 🙂 I haven't done that yet. Can you point me to a library that generates them automatically?
# capjamesg[d] Sorry, I meant generates documentation from docstrings. I know I need to write my own docstrings 🙂
# capjamesg[d] Regarding setup, the config.cfg file should auto-install any required dependencies when it is built for those who install via pip. I don't know if that carries along to local setup though. Good idea re: development section [snarfed]++
# capjamesg[d] [tantek]++ for the help!
# capjamesg[d] I have all of the code ready and will open-source it. It will not be ready for production use for a bit though. I'll have to modify a few of my projects to remove this code (which has been repetitive across a number of codebases) and use the library instead.
# capjamesg[d] I'm so excited about this!
# [snarfed] capjamesg https://readthedocs.org/ is the most common service for auto generating python docs. it uses sphinx and friends, which are the standard toolchain for python
# [snarfed] `sphinx-build -b html html/` is a miminal command line. example output: https://granary.readthedocs.io/
# capjamesg[d] I have set up a read the docs page.
# capjamesg[d] Now I’ll just have to move my docs over there. I’ll need to read what the folder / doc structure looks like.
# capjamesg[d] Thus far the setup process has been nice.
# [snarfed] pandoc on RTD, probably! I do it semi manually, https://github.com/snarfed/granary/blob/main/docs/build.sh , but not often, most of my doc changes are in docstrings
lagash joined the channel
# capjamesg[d] [snarfed] quick point of clarification. Do I need to keep my project itself in the same repo as the docs?
# capjamesg[d] I’m not doing anything else today but am trying to build a mental map of what I’ll need to do.
sayanarijit[d], sarahd[d], KartikPrabhu and lagash joined the channel
Darius_Dunlap[d] joined the channel
KartikPrabhu joined the channel
# capjamesg[d] That makes sense. Thanks tantek!
# capjamesg[d] I greatly appreciate everyone’s help!
# 
[chrisaldrich] doubleloop[m], thanks for the details. If you need it, here's that repo for hashtag support for WordPress that will auto-create WP tags https://github.com/pfefferle/wordpress-hashtags. I'm guessing it could be modified to do the same thing but with [[wikilinks]].
[tw2113_Slack_] joined the channel
# [tw2113_Slack_] hmm
# [tw2113_Slack_] ooh, basically turns hashtags into term archive links
# [tw2113_Slack_] i could use that on one of my sites
[manton] joined the channel
# [Joe_Crawford] I’m also looking at that repo. My goal is to make a version that is not automatic and also pulls from the post title — and also adds a step where they are not automatic but suggested for import when a post is opened for editing.
# 
@jimmyzelinskie ↩️ I don't know much about how this works, but could something like IndieAuth be used to support OIDC and still maintain decentralization? https://en.wikipedia.org/wiki/IndieAuth (twitter.com/_/status/1468346968762208262)
[fluffy]1 and gRegor joined the channel
tetov-irc joined the channel