Skip to content

Commit ee2e9b4

Browse files
Kikobeatsclaude
andauthored
docs: cleanup expired links (#896)
- Add Microlink Embed to 7.2 Consumers - Add microlinkhq/oembed-spec to 7.3 Libraries - Merge the two "Press and Links" lists to remove the gap between them - Add a Dockerfile (PHP + yaml ext) and a Development section to the README so the site can be rendered locally without touching the host - Fix dead links found while testing: update Perl Web-oEmbed to its metacpan URL, and drop the defunct php-oembed (Google Code) and .Net CodePlex listings Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 2a77e82 commit ee2e9b4

3 files changed

Lines changed: 33 additions & 5 deletions

File tree

Dockerfile

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
FROM php:8.3-cli
2+
3+
# The site (www/index.php) parses provider YAML files via yaml_parse_file(),
4+
# which requires the PECL yaml extension.
5+
RUN apt-get update \
6+
&& apt-get install -y --no-install-recommends libyaml-dev \
7+
&& pecl install yaml \
8+
&& docker-php-ext-enable yaml \
9+
&& rm -rf /var/lib/apt/lists/*
10+
11+
WORKDIR /var/www/html
12+
13+
# Serve www/ as the docroot; index.php reads ../providers relative to it.
14+
EXPOSE 8000
15+
CMD ["php", "-S", "0.0.0.0:8000", "-t", "/var/www/html/www"]

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,21 @@ If you need to use the provider registry directly, you can install this package
1919
That will install the providers file into `node_modules/oembed-providers/providers.json`, where you can ingest it directly.
2020

2121

22+
## Development
23+
24+
The website (`www/index.php`) is rendered by PHP and uses the [`yaml`](https://www.php.net/manual/en/book.yaml.php) extension to count the providers in the registry. The included `Dockerfile` provides a PHP runtime with that extension already set up, so you don't need to install anything locally.
25+
26+
Build the image once:
27+
28+
docker build -t oembed-site .
29+
30+
Then run it, mounting the repo so edits are picked up live:
31+
32+
docker run --rm -p 8000:8000 -v "$PWD":/var/www/html oembed-site
33+
34+
Open <http://localhost:8000> to see the site. Editing `www/index.php` and refreshing the page is enough — no rebuild required.
35+
36+
2237
## Maintainers: Publishing to NPM
2338

2439
* Update version in `package.json` to today's date

www/index.php

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -472,28 +472,28 @@
472472
<ul>
473473
<li>Iframely (<a href="http://iframely.com/">http://iframely.com/</a>)</li>
474474
<li>OEmbed Link Viewer (<a href="https://oembed.link/">https://oembed.link/</a>)</li>
475+
<li>Microlink Embed (<a href="https://microlink.io/embed">https://microlink.io/embed</a>)</li>
475476
</ul>
476477

477478
<a name="section7.3" id="section7.3"><h3>7.3. Libraries</h3></a>
478479

479480
<ul>
480-
<li>PHP: php-oembed (<a href="http://code.google.com/p/php-oembed/">http://code.google.com/p/php-oembed/</a>)</li>
481481
<li>PHP: Services_oEmbed (<a href="http://pear.php.net/package/Services_oEmbed">http://pear.php.net/package/Services_oEmbed</a>)</li>
482482
<li>PHP: Essence (<a href="https://github.com/felixgirault/essence">https://github.com/felixgirault/essence</a>)</li>
483483
<li>PHP: Embera (<a href="https://github.com/mpratt/Embera">https://github.com/mpratt/Embera</a>)</li>
484-
<li>Perl: Web-oEmbed (<a href="http://search.cpan.org/~miyagawa/Web-oEmbed/">http://search.cpan.org/~miyagawa/Web-oEmbed/</a>)</li>
484+
<li>Perl: Web-oEmbed (<a href="https://metacpan.org/release/Web-oEmbed">https://metacpan.org/release/Web-oEmbed</a>)</li>
485485
<li>Ruby: oembed_links (<a href="http://github.com/netshade/oembed_links">http://github.com/netshade/oembed_links</a>)</li>
486486
<li>Python: pyoembed (<a href="http://github.com/rafaelmartins/pyoembed/">http://github.com/rafaelmartins/pyoembed/</a>)</li>
487487
<li>Python: PyEmbed (<a href="http://pyembed.github.io">http://pyembed.github.io</a>)</li>
488488
<li>Python: python-oembed (<a href="https://github.com/abarmat/python-oembed">https://github.com/abarmat/python-oembed</a>)</li>
489489
<li>Django: micawber (<a href="https://github.com/coleifer/micawber">https://github.com/coleifer/micawber</a>)</li>
490490
<li>Java: java-oembed (<a href="https://github.com/michael-simons/java-oembed">https://github.com/michael-simons/java-oembed</a>)</li>
491-
<li>.Net: oEmbed API Wrapper (<a href="http://oembed.codeplex.com/">http://oembed.codeplex.com/</a>)</li>
492491
<li>JQuery: oEmbed API Wrapper (<a href="https://github.com/starfishmod/jquery-oembed-all">https://github.com/starfishmod/jquery-oembed-all</a>)</li>
493492
<li>Node.js: oEmbed API Gateway (<a href="https://github.com/itteco/iframely">https://github.com/itteco/iframely</a>)</li>
494493
<li>Elixir: furlex (<a href="https://github.com/claytongentry/furlex">https://github.com/claytongentry/furlex</a>)</li>
495494
<li>Elixir: elixir-oembed (<a href="https://github.com/r8/elixir-oembed">https://github.com/r8/elixir-oembed</a>)</li>
496495
<li>AWS: Serverless oEmbed provider (<a href="https://github.com/aws-samples/sample-serverless-oembed">https://github.com/aws-samples/sample-serverless-oembed</a>)</li>
496+
<li>Node.js: oembed-spec (<a href="https://github.com/microlinkhq/oembed-spec">https://github.com/microlinkhq/oembed-spec</a>)</li>
497497
</ul>
498498

499499

@@ -503,8 +503,6 @@
503503

504504
<ul>
505505
<li><a href="http://groups.google.com/group/oembed/">The official oEmbed mailing list</a></li>
506-
</ul>
507-
<ul>
508506
<li><a href="https://web.archive.org/web/20150318024249/https://www.wired.com/2010/02/get_started_with_oembed/">Webmonkey tutorial</a></li>
509507
<li><a href="https://blog.leahculver.com/2008/05/announcing-oembed-an-open-standard-for-embedded-content.html">Leah's blog</a></li>
510508
<li><a href="http://ajaxian.com/archives/oembed-makes-embedding-third-party-videos-and-images-a-breeze">ajaxian</a></li>

0 commit comments

Comments
 (0)