Comments (4)
I agree that what we have right now is not pretty. The problem is that those characters are not unreserved according to the URI specification, so we have to mangle them. If you have an alternate solution that is more legible and equally functional, let me know.
from hyde.
Well, one hack would be to borrow angle brackets from unicode. U+3008 and U+3009,〈〉. From my cursory reading, they are allowed in URIs, but not in C++ identifiers. (This could be wrong, I didn't dig too deep.) There are some obvious downsides, but it's a solution.
from hyde.
In the same spirit, but looking a little bit better are small less and greater unicode signs, U+FE64 and U+FE65, ﹤﹥.
from hyde.
Originally I was going to restrict the characters to the URI RFC, which requires that any non-unreserved characters be encoded. This would also require Unicode characters to be UTF-8 encoded and then escaped. However I am starting to rethink my decision on this, and am willing to consider using the IRI standard for naming instead. That would give us a lot more flexibility in terms of the characters we can use in the paths, and would let us scale back the kind of mangling we'd need to do. I appreciate your input; let me think about it a bit more.
from hyde.
Related Issues (20)
- Remove dependencie on Xcode HOT 9
- Documentation: No`--with-static-lib` option form yaml-cpp
- Templates: no baseurl support HOT 1
- Command Line Options - relative paths inconsistent HOT 2
- Not finding path for standard library
- Allow specifying substitution characters HOT 1
- error: control reaches end of non-void function [-Werror=return-type] HOT 1
- Switch to more inclusive language HOT 1
- Incorrect Directory Titles HOT 1
- Make Complete How-to from Running Hyde, Writing Documentation to Serving in Jekyll HOT 2
- -hyde-json project? HOT 2
- "title" should be scalar, not editable scalar HOT 1
- Set tested_by to __OPTIONAL__ by default for anything that’s compiler-generated.
- use hyde as a clang-doc generator HOT 1
- Building fails on Ubuntu 20.04
- Empty enums generate error
- `--infer-owner` with `git blame`
- Hyde update should reflect unknown tags in the YAML/JSON HOT 1
- Alter project so builds fail faster
- Improve version information output
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from hyde.