[DOCS-8452] Support styling for external links (e.g. to reference docs without a sphinx inventory) Created: 28/Jul/16  Updated: 30/Oct/23  Resolved: 09/Mar/22

Status: Closed
Project: Documentation
Component/s: tools
Affects Version/s: None
Fix Version/s: Server_Docs_20231030

Type: Improvement Priority: Major - P3
Reporter: Allison Reinheimer Moore Assignee: Jonathan DeStefano
Resolution: Won't Fix Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 3 years, 34 weeks ago

 Description   

It would be helpful to be able to make a link to an external page (e.g. to the mongodb php extension reference) be fixed width. This is absolutely not something that sphinx/docutils supports and it doesn't seem like that's likely to come about in the near future.

The workaround is to use a combination of substitutions, references, and the replace directive, which is obviously not something we're going to do.

extlinks in conf.py, which makes it easier to link out to stuff, does not allow you to style the links though it does support adding a prefix to it that must be a string. Perhaps that's an avenue to investigate. Intersphinx doesn't work for non-sphinx projects, though that would be a lovely alternative.

As the driver docs move more and more to ReST, this is – I think – something we'll need to sort out.



 Comments   
Comment by Githook User [ 17/Jun/20 ]

Author:

{'name': 'Sue K', 'email': 'sue.kerschbaumer@10gen.com', 'username': 'skerschb'}

Message: Merge pull request #111 from madelinezec/DOCS-8452

Docs 8452 - Regression Tests
Branch: master
https://github.com/mongodb/docs-worker-pool/commit/65e8d68bf166b52edef8f98c19e0ea3f51b6c452

Comment by Githook User [ 17/Jun/20 ]

Author:

{'name': 'madelinezec', 'email': 'maddie.zechar@mongodb.com', 'username': 'madelinezec'}

Message: Merge branch 'stage' of github.com:mongodb/docs-worker-pool into DOCS-8452
Branch: master
https://github.com/mongodb/docs-worker-pool/commit/bd4cbb32dbbefb79312fcc363e869638807c42f0

Comment by Githook User [ 17/Jun/20 ]

Author:

{'name': 'madelinezec', 'email': 'maddie.zechar@mongodb.com', 'username': 'madelinezec'}

Message: Merge branch 'stage' of github.com:mongodb/docs-worker-pool into DOCS-8452
Branch: master
https://github.com/mongodb/docs-worker-pool/commit/3968102a85dd2f1ae9f112e85f123b1323443e7f

Comment by Githook User [ 17/Jun/20 ]

Author:

{'name': 'madelinezec', 'email': 'mez2113@columbia.edu', 'username': 'madelinezec'}

Message: Merge remote-tracking branch 'upstream/stage' into DOCS-8452
Branch: master
https://github.com/mongodb/docs-worker-pool/commit/fb416c6a51c3eff4dd69d4ade7d8099e8529cb79

Generated at Thu Feb 08 07:56:20 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.