[PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Suhail Singh]

* org-contrib/babel/languages/ob-doc-gnuplot.org (Introduction): Fix
link to source.
---
 org-contrib/babel/languages/ob-doc-gnuplot.org | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/org-contrib/babel/languages/ob-doc-gnuplot.org b/org-contrib/babel/languages/ob-doc-gnuplot.org
index 4bcca41d..d51102d2 100644
--- a/org-contrib/babel/languages/ob-doc-gnuplot.org
+++ b/org-contrib/babel/languages/ob-doc-gnuplot.org
@@ -34,7 +34,7 @@ * Introduction
 usage. Since babel is simply allowing native code to run inside of
 Org-mode, all gnuplot documentation is applicable and valid. [fn:1]
 
-This file may be downloaded here: [[https://orgmode.org/worg/sources/org-contrib/babel/examples/org-babel-gnuplot.org][org-babel-gnuplot.org]]. The image
+This file may be downloaded here: [[https://orgmode.org/worg/org-contrib/babel/examples/org-babel-gnuplot.org][org-babel-gnuplot.org]]. The image
 links are to the images online on Worg, but running the code blocks
 will produce matching images in the same directory as the .org file.
 

base-commit: db73ab050bd884bdc7a062aeb9042f5e659854ff

Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Max Nikulin]

On 29/11/2024 23:26, Suhail Singh wrote:
> -This file may be downloaded here: [[https://orgmode.org/worg/sources/org-contrib/babel/examples/org-babel- 
> gnuplot.org][org-babel-gnuplot.org]]. The image
> +This file may be downloaded here: [[https://orgmode.org/worg/org-contrib/babel/examples/org-babel-gnuplot.org][org-babel-gnuplot.org]]. The image

Thanks.

I am in doubts what kind of links should be used. Bastien committed a 
lot of git.sr.ht links:
https://git.sr.ht/~bzg/worg/commit/e26fa7ba00#org-contrib/babel/uses.org

I expected to find a macro for this purpose, but it seems there is no one.

Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Suhail Singh]

Max Nikulin <manikulin@gmail.com> writes:

> I am in doubts what kind of links should be used. Bastien committed a lot of
> git.sr.ht links:
> https://git.sr.ht/~bzg/worg/commit/e26fa7ba00#org-contrib/babel/uses.org
>
> I expected to find a macro for this purpose, but it seems there is no one.

Yes, either macros or link abbreviations would help in this regard.
It's on my list of things to submit patches for when I get around to it,
unless someone else beats me to it.

For now, I simply wanted to ensure the link was no longer broken.  Feel
free to discard the patch in favor of another that addresses the issue
generically.

-- 
Suhail

Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Max Nikulin]

On 03/12/2024 02:32, Suhail Singh wrote:
> Max Nikulin writes:
> 
> For now, I simply wanted to ensure the link was no longer broken.  Feel
> free to discard the patch in favor of another that addresses the issue
> generically.

I have pushed a commit changing worg/sources/ links to git.sr.ht in 3 
files. Accordingly to

git grep --count \
     '\[https://git\.sr\.ht/~bzg/worg/tree/master/item/[^]]*\.org\]'
git grep --count '\[https://orgmode.org/[^]]*\.org\]'

the former used more often. HTML files will be updated when Ihor push 
some changes next time.

I recall a discussion whether a link to source file should be added to 
every worg page.

Cancelled.

Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Max Nikulin]

On 29/11/2024 23:26, Suhail Singh wrote:
> +++ b/org-contrib/babel/languages/ob-doc-gnuplot.org
> @@ -34,7 +34,7 @@ * Introduction
>   usage. Since babel is simply allowing native code to run inside of
>   Org-mode, all gnuplot documentation is applicable and valid. [fn:1]
>   
> -This file may be downloaded here: [[https://orgmode.org/worg/sources/org-contrib/babel/examples/org-babel- 
> gnuplot.org][org-babel-gnuplot.org]]. The image

I have realized that ob-doc-gnuplot.org and org-babel-gnuplot.org files 
are quite similar. The latter have not got some recent update though. I 
think, the former may use noweb to have source code blocks active while 
using the same content for exporting with header arguments. Are there 
any other reason why duplicated content exists? I would drop one file to 
avoid divergence.

Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Suhail Singh]

Max Nikulin <manikulin@gmail.com> writes:

> I have realized that ob-doc-gnuplot.org and org-babel-gnuplot.org files are
> quite similar.

Good catch!

The latter have not got some recent update though. I think, the
> former may use noweb to have source code blocks active while using the same
> content for exporting with header arguments.

> Are there any other reason why duplicated content exists? I would drop
> one file to avoid divergence.

Looking briefly into it, it's not clear to me that the inclusion of
org-babel-gnuplot.org in commit 394a6326881fc1f077ca8f4b891d8f133f80d305
wasn't an accident.

It might make sense to include an examples/plotting.org at some point,
with very different content.  But as things stand today I believe of the
two files ob-doc-gnuplot.org is the one that should be retained and if
there's any meaningful information contained in org-babel-gnuplot.org
which isn't yet in ob-doc-gnuplot.org that it should be assimilated into
ob-doc-gnuplot.org.

PS: please include my address in replies.

-- 
Suhail

Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.

[Ihor Radchenko]

Max Nikulin <manikulin@gmail.com> writes:

> On 03/12/2024 02:32, Suhail Singh wrote:
>> Max Nikulin writes:
>> 
>> For now, I simply wanted to ensure the link was no longer broken.  Feel
>> free to discard the patch in favor of another that addresses the issue
>> generically.
>
> I have pushed a commit changing worg/sources/ links to git.sr.ht in 3 
> files. Accordingly to
>
> git grep --count \
>      '\[https://git\.sr\.ht/~bzg/worg/tree/master/item/[^]]*\.org\]'
> git grep --count '\[https://orgmode.org/[^]]*\.org\]'
>
> the former used more often. HTML files will be updated when Ihor push 
> some changes next time.

Ideally, we want to use a simple [[./file.org]] links. But it is
actually tricky because of `org-html-link-org-files-as-html'.
So, direct http link has to do for now.

> I recall a discussion whether a link to source file should be added to 
> every worg page.

Do you have a link to that discussion?

-- 
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Linking source files on worg (was: Re: [PATCH worg v2] ob-doc-gnuplot.org: Fix broken link to source.)

[Max Nikulin]

On 11/12/2024 02:25, Ihor Radchenko wrote:
> Ideally, we want to use a simple [[./file.org]] links. But it is
> actually tricky because of `org-html-link-org-files-as-html'.
> So, direct http link has to do for now.

I would say e.g. [[org-src:file.org]] while simple [[file:file.org]] is 
for the *exported* page.

I am unsure how many external sites have links to 
https://orgmode.org/worg/sources/* and whether it should be handled by a 
nginx redirection rule.

> Max Nikulin writes:
>> I recall a discussion whether a link to source file should be added to
>> every worg page.
> 
> Do you have a link to that discussion?

<https://list.orgmode.org/87wncxztzb.fsf@gmail.com/>
Tim Cross. Re: Serving .org files for worg (was: Re: Library of babel 
help) 2022-06-30 21:48 UTC
> My main issue is that having to know you can change the suffix from
> .html to .org in order to get the source is insufficient. It won't be
> obvious to many users and will only make some sense to experienced org
> users. I think the link should be obvious and I think the server
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> configuration should be set so that accessing the .org url gives a
> sensible result (i.e. prefer opening it as plain text to offering to
> download).

Accordingly to
<https://emacs.stackexchange.com/questions/19905/where-can-i-find-the-org-source-code-for-orgmode-org-manual-installation-html>
buttons to obtain .org files were there in the past

See at the bottom
<https://web.archive.org/web/20151218202033/http://orgmode.org/worg/index.html>