Comments (7)
theidexisted
commented on July 30, 2024
This is a bug in elinks, which is an independent program, we spawn subprocess to run elinks and render the HTML pages.
The lastest update for elinks is 2012-10-30, so I would not expect them to fix it.
from stdman.
theidexisted
commented on July 30, 2024
@jeaye Could you please review this issue?
from stdman.
jeaye
commented on July 30, 2024
I've recently been thinking about trying out https://www.brow.sh/ instead of elinks. It should offer much better rendering, since it just uses a headless Firefox. The only question would be around rendering a full frame to a string and pulling out the content we need. If you're looking for something to dig into, that would be a huge step for stdman's formatting.
from stdman.
theidexisted
commented on July 30, 2024
@jeaye
Thanks for your guide, I have tried with Browsh, but it can't rend the equation correctly, though it's much better than Elinks
from stdman.
theidexisted
commented on July 30, 2024
I have also tested Browsh for this page:
https://en.cppreference.com/w/cpp/string/basic_string
For the Helper classes section, Browsh rend it as:
Helper classes
std::hash (C++11)
std::hash (C++20)
std::hash (C++11)
std::hash (C++11)
std::hash (C++11) hash support for strings
std::hash (C++20) (class template specialization)
std::hash (C++20)
std::hash (C++20)
std::hash (C++20)
std::hash (C++20)
Which is still not perfect.
For elinks, it generates:
Helper classes
std::hash<std::string>
std::hash<std::u8string>
std::hash<std::u16string>
std::hash<std::u32string>
std::hash<std::wstring>
std::hash<std::pmr::string>
std::hash<std::pmr::u8string>
std::hash<std::pmr::u16string>
std::hash<std::pmr::u32string>
std::hash<std::pmr::wstring> hash support for strings
(C++11) (class template specialization)
(C++20)
(C++11)
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Browsh looks better, but still not ideal.
Of course, this may also be due to the cpprefencen template itself has some problems, I can not copy this paragraph in its original style. When I copy the table and paste, we get the text in mess:
std::hash<std::string>std::hash<std::u8string>std::hash<std::u16string>std::hash<std::u32string>std::hash<std::wstring>std::hash<std::pmr::string>std::hash<std::pmr::u8string>std::hash<std::pmr::u16string>std::hash<std::pmr::u32string>std::hash<std::pmr::wstring>(C++11)(C++20)(C++11)(C++11)(C++11)(C++20)(C++20)(C++20)(C++20)(C++20) | hash support for strings(class
-- | --
from stdman.
jeaye
commented on July 30, 2024
Thanks so much for testing this. It does seem like cppref may be the issue for the the last bit. Copy/paste is always a good test for how things will render in text.
Outside of that, though, browsh does a much nicer job than elinks. Do you see any potential issues in stdman using browsh for generation instead? The only thing I noticed is that browsh is rendering ads; I wonder if we can configure it to use uBlock Origin. If not, we can just cut out that bit of the HTML.
from stdman.
theidexisted
commented on July 30, 2024
I will make a proposal later, I need to go through the current source code of stdman
from stdman.
Related Issues (20)
- Can't open man page for std::ref and others HOT 9
- std::async Synopsis formatting is messed up HOT 1
- New release HOT 1
- mac HOT 1
- Tags/Releases synced with cppreference archive updates HOT 3
- cannot completion when pressing man std::string:: + tab HOT 5
- No manual entry for std::string_view HOT 1
- Suggestion to avoid need for MANPATH or installation in /usr/local
- functional manpage HOT 1
- How to man same name but from different header?
- cannot completion when pressing man std::string:: + tab HOT 1
- Minor cleanup coding format of <code>...</code>
- No manual entry for member functions HOT 6
- new tag release? HOT 2
- Non-printing characters in some manpages
- Some of the man pages don't include the examples from the website HOT 3
- Tag for 2022.02.01 missing? HOT 1
- New release HOT 5
- mandb warnings with some operators
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 stdman.