CARVIEW

MOTORHOMES

Select Language

HTTP/2 302 server: nginx date: Tue, 23 Dec 2025 17:58:20 GMT content-type: text/plain; charset=utf-8 content-length: 0 x-archive-redirect-reason: found capture at 20100619021507 location: https://web.archive.org/web/20100619021507/https://github.com/github/markup/issues server-timing: captures_list;dur=0.879613, exclusion.robots;dur=0.074812, exclusion.robots.policy;dur=0.057541, esindex;dur=0.014720, cdx.remote;dur=19.191197, LoadShardBlock;dur=212.110673, PetaboxLoader3.datanode;dur=131.985138, PetaboxLoader3.resolve;dur=28.322972 x-app-server: wwwb-app222-dc8 x-ts: 302 x-tr: 272 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 set-cookie: wb-p-SERVER=wwwb-app222; path=/ x-location: All x-as: 14061 x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() HTTP/2 200 server: nginx date: Tue, 23 Dec 2025 17:58:22 GMT content-type: text/html; charset=utf-8 x-archive-orig-server: nginx/0.7.61 x-archive-orig-date: Sat, 19 Jun 2010 02:15:07 GMT x-archive-orig-connection: close x-archive-orig-status: 200 OK x-archive-orig-etag: "fa13bf9c08f942c68cb65af1ae5e35cb" x-archive-orig-x-runtime: 59ms x-archive-orig-content-length: 28845 x-archive-orig-cache-control: private, max-age=0, must-revalidate x-archive-guessed-content-type: text/html x-archive-guessed-charset: utf-8 memento-datetime: Sat, 19 Jun 2010 02:15:07 GMT link: ; rel="original", ; rel="timemap"; type="application/link-format", ; rel="timegate" content-security-policy: default-src 'self' 'unsafe-eval' 'unsafe-inline' data: blob: archive.org web.archive.org web-static.archive.org wayback-api.archive.org athena.archive.org analytics.archive.org pragma.archivelab.org wwwb-events.archive.org x-archive-src: 52_16_20100618235925_crawl103-c/52_16_20100619021409_crawl101.arc.gz server-timing: captures_list;dur=0.503171, exclusion.robots;dur=0.019070, exclusion.robots.policy;dur=0.008769, esindex;dur=0.009712, cdx.remote;dur=14.925922, LoadShardBlock;dur=1962.903623, PetaboxLoader3.resolve;dur=1041.758282, PetaboxLoader3.datanode;dur=577.137160, load_resource;dur=113.995627 x-app-server: wwwb-app222-dc8 x-ts: 200 x-tr: 2160 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 x-location: All x-as: 14061 x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() content-encoding: gzip Issues - github/markup - GitHub

github / markup

Source
Commits
Network (8)
Issues (3)
Graphs
Branch: master

Sort By: Priority | Votes | Last Updated

Loading…

3.

0 votes

Try to figure out the markup type of extensionless README files
1 comment Created 3 months ago by avar
It's somewhat common especially for Perl projects to have POD markdown in a README file without a .pod extension, here's one example of this.

The simplest way to support this would be to simply shell out to file(1) for README files:
```
v rakudo (master) $ file README 
README: Perl POD document text
```
Comments
Ciantic Fri Mar 05 09:22:14 -0800 2010 | link
Instead of figuring it out, make select box where one can choose it, perhaps to Admin panel of project.

Auto guess the markup from extension, set the select option in Admin panel to this default guessed value.

By having this select box, one can override the guessed value if it turns out badly.

Here is one example why valid files turns out badly:

Because some rST files require additional directives/etc which are not defined within GitHub, and is rendered very badly, see e.g. my Sphinkydoc README perfectly valid Sphinx documentation rST cannot be rendered in GitHub. So I have option by removing extension, to render it as plain text. But that is crude option, there should be a way to override it even though my file were named README.rst.
Comment
Instead of figuring it out, make select box where one can choose it, perhaps to Admin panel of project. 1. Auto guess the markup from extension, set the *select option* in Admin panel to this default guessed value. 2. By having this select box, one can override the guessed value if it turns out badly. Here is one example why valid files turns out badly: Because some rST files require *additional directives/etc* which are not defined within GitHub, and is rendered very badly, see e.g. my [Sphinkydoc README](https://github.com/Ciantic/sphinkydoc/tree/724d92d0b173230548d57d4d103c180925b35841) perfectly valid Sphinx documentation rST cannot be rendered in GitHub. So *I have option* by removing extension, to render it as plain text. But that is crude option, there should be a way to override it even though my file were named `README.rst`.
or cancel
Please log in to comment.
5.

0 votes

The 'issues' link in the README points to defunkt's project
0 comments Created about 1 month ago by jrom

And it should be github's.

Comments

Please log in to comment.
6.

0 votes

markdown headers should have anchors
4 comments Created about 1 month ago by technoweenie
Anchors are great for usability in long documentation.
```
# Install
blah blah
<h1 name="INSTALL">Install</h1>
<p>blah blah</p>
https://github.com/user/repo#INSTALL
```
Comments
kennethreitz Sun May 09 14:07:47 -0700 2010 | link
Should be:

<h1 id="INSTALL">Install</h1> <p>blah blah</p>

Name isn't a valid xhtml attribute for headers.
Comment
Should be: <h1 id="INSTALL">Install</h1> <p>blah blah</p> Name isn't a valid xhtml attribute for headers.
or cancel
technoweenie Sun May 09 14:09:45 -0700 2010 | link

ah, i'm old school :)

Comment
ah, i'm old school :)
or cancel

kennethreitz Sun May 09 14:12:19 -0700 2010 | link

Haha!

The MultiMarkdown renderer included in TextMate does this already.

Blech it's in Perl, but it's a pretty good implementation if you're looking for an example.

Comment
Haha! The [MultiMarkdown](https://fletcher.github.com/MultiMarkdown/) renderer included in TextMate does this already. Blech it's in Perl, but it's a pretty good implementation if you're looking for an example.
or cancel

dabrahams Wed May 19 11:25:02 -0700 2010 | link

+1

Comment
+1
or cancel

Please log in to comment.

Labels

Original Source | Taken Source

github / markup

Try to figure out the markup type of extensionless README files

Comments

The 'issues' link in the README points to defunkt's project

Comments

markdown headers should have anchors

Comments