💾 Archived View for gemi.dev › gemini-mailing-list › 000415.gmi captured on 2023-12-28 at 15:46:43. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2023-11-04)

🚧 View Differences

-=-=-=-=-=-=-

Preferred convention for converting inline links?

1. jan Niko (Nico) (nihilazo (a) protonmail.com)

Hi,
I'm new to gemini and I'd like to make my website (https://itwont.work) 
also available as a gemini site (capsule? Not sure what the terminology is).
The site is a wiki-style site and as a result of that contains a lot of 
inline links. I'm not sure what the convention for converting that to 
gemini text is, given that there is no inline links in text in gemini. The 
two ideas I have for this are making them like footnotes or just putting 
them the line after.

For example, if I have a markdown line like this:

Mine is running arch linux, with a GUI built around sway, waybar, and 
[sike](sike.md). The on-screen keyboard is 
[squeekboard](https://source.puri.sm/Librem5/squeekboard) with a custom 
split layout. (if people are interested in the UI setup, I'll make a page for it)

Would it be better to turn it into gemini text like this:

Mine is running arch linux, with a GUI built around sway, waybar, and 
sike. The on-screen keyboard is squeekboard with a custom split layout. 
(if people are interested in the UI setup, I'll make a page for it)

=> https://source.puri.sm/Librem5/squeekboard Squeekboard
=> gemini://itwont.work/sike.gmi sike

or more like this?

Mine is running arch linux, with a GUI built around sway, waybar, and 
sike[1]. The on-screen keyboard is squeekboard[2] with a custom split 
layout. (if people are interested in the UI setup, I'll make a page for it)

[...rest of file here...]

=> https://source.puri.sm/Librem5/squeekboard [1] Squeekboard
=> gemini://itwont.work/sike.gmi [2] sike

Or is there another convention for this?

Thanks,
Nico

Link to individual message.

2. Drew DeVault (sir (a) cmpwn.com)

On Fri Oct 23, 2020 at 1:32 PM EDT, jan Niko (Nico) wrote:
> Mine is running arch linux, with a GUI built around sway, waybar, and
> sike. The on-screen keyboard is squeekboard with a custom split layout.
> (if people are interested in the UI setup, I'll make a page for it)
>
> => https://source.puri.sm/Librem5/squeekboard Squeekboard
> => gemini://itwont.work/sike.gmi sike

I prefer this approach. Sometimes if I have a lot of references, I'll
make use of unicode superscript numerals to prepare a list of footnotes:

https://en.wikipedia.org/wiki/Unicode_subscripts_and_superscripts#Superscri
pts_and_subscripts_block

However, in general, I avoid numbered links, because many clients assign
a number to each link for keyboard shortcuts and ease of use, and if my
numbering doesn't line up it could lead to confusion.

But also, as a general rule, I don't do automated conversions of
non-Gemini content to Gemtext. Instead, I manually reformat it as
Gemtext so that I can use editorial descretion to adjust the content to
better express itself in the conventions of the new medium.

Link to individual message.

3. Luke Emmet (luke (a) marmaladefoo.com)

On 23-Oct-2020 18:32, jan Niko (Nico) wrote:
> I'm new to gemini and I'd like to make my website (https://itwont.work) 
also available as a gemini site (capsule? Not sure what the terminology is).
> The site is a wiki-style site and as a result of that contains a lot of 
inline links. I'm not sure what the convention for converting that to 
gemini text is, given that there is no inline links in text in gemini. The 
two ideas I have for this are making them like footnotes or just putting 
them the line after.

Hi Nico

I think both are fine - there is no single established convention on 
this. Perhaps from gopher, the square bracket or unicode superscript 
footnote convention is reasonably well established, but simply emitting 
them after the relevant paragraph is OK too. Personally I prefer there 
to be a citation marker, as it makes it easier to see where the citation 
is made. Others prefer to just list the links without citation 
placemarkers, perhaps not even numbered.

I have a utility html2gmi which has to solve the same problem - it 
provides a number of options, including whether to number the citation 
placeholders, to number the footnote links, and the frequency of 
emitting the links within the document.

https://github.com/LukeEmmet/html2gmi

So horses for courses you might say.

  - Luke

Link to individual message.

---

Previous Thread: [ANN] GemBoard - Anonymous Textboard

Next Thread: Announcing go-gemini, a Go library implementing the Gemini protocol