Comments (3)
We still have some outstanding approaches to resolve to figure out the tooling we want for this. For example, Turndown allows us to transform HTML -> Markdown, but this may not be flexible enough for our needs. We need to evaluate the tools MDX uses as well that transforms the MDX content into an AST, which we can then run transforms on. That approach is much more flexible but at the cost of added complexity.
from docs-website.
Looks like turndown doesn't parse our <pre>
blocks out of the box because it expects <pre><code>...</code></pre>
. so the code blocks are just paragraph lines and gatsby mdx chokes on periods and curly brackets (because they're not parsed and escaped as part of code block). We'll likely be component-izing these anyway, but this tripped me up.
https://domchristie.github.io/turndown/
from docs-website.
This was somewhat address in #66 (separating how we process docs by type), but we could still do some work to implement the actual "code mod" system.
from docs-website.
Related Issues (20)
- Feedback on the docs: Bash Command is confusing HOT 3
- .NET Lambda installation steps in wrong section HOT 2
- link to open telemetry collector for infrastructure is not working HOT 2
- Broken link(s) found HOT 1
- Broken link(s) found
- k8s-agents-operator documentation has invalid nodejs docker reference HOT 1
- Broken link(s) found
- Broken link(s) found
- Issue: 404 HOT 2
- Broken link(s) found
- Issue: 404 Cloudwatch Plugin documentation 404 HOT 2
- docs: Prometheus integrations list is outdated HOT 2
- Broken link(s) found
- Update pages screenshots with the new Timewarp HOT 2
- DT API required shown as not required HOT 2
- Outdated Session Tracking doc page HOT 2
- Broken link(s) found
- Confusing instructions for aws integration may lead users to wrong integration method HOT 2
- Broken link(s) found
- Broken link(s) found
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 docs-website.