Comments (5)
The rst files are downloaded automatically from transifex and then documentation is built. If you have a slow connection that may take some time, but also it gets cached on your local, so it will be faster the next time.
As said on the README.md, if you want to force a download a get all the latest files you should use the mvn clean install -Dlatest profile to make sure latest transifex files are downloaded. Transifex should be smart and download only the updates.
Those rst files shouldn't be in the repository. If they are there, that's a mistake, they should be downloaded from Transifex. Unless you want to do the cache on github.
from doc.
The cache doesn't seem to do too much. When I execute mvn clean install
it seems building several times, I guess for each language? Would be good if that's the case, to be able to configure the languages and maybe by default only build english.
Those rst files shouldn't be in the repository: they are already there https://github.com/geonetwork/doc/tree/develop/source and I don't think is clear how to manage the documentation now. I did yesterday a PR updating the documentation: #28, but there're still some pending pull requests.
Can you point to some documentation about how should be handled the documentation?
from doc.
Yes, it builds all the languages. If you want to build only one language, the easiest way right now is to edit this line: https://github.com/geonetwork/doc/blob/develop/Makefile#L60
Yes, maybe we should add that as parameter too.
from doc.
The documentation about the documentation is in: https://github.com/geonetwork/doc/blob/develop/README.md
What I did is just add the multilingual part, the rest is the same as it was before.
from doc.
@josegar74 is this still a problem with the updated build process? Building a single language seems pretty quick now, but building all languages still takes about 5 minutes
from doc.
Related Issues (20)
- Changelog Review (3.8.0/3.8.1): Associated resources page needs updating HOT 1
- Changelog Review (3.8.0): Thredds harvester page needs updating
- Changelog Review (3.8.2): CSW Harvester page needs updating
- Update QuickStart contents
- Update maintainer guide
- docs not clear where es/config scripts are located HOT 1
- Versioning docs missing HOT 2
- Autoupdate has stopped for a resource
- Use of master/minion in documentation HOT 1
- opensearch documentation
- Updating the application: manual section without content HOT 3
- wro4j inspected folders
- Failed Deployment WAR using jboss EAP 7.4 HOT 1
- Missing example event listener HOT 2
- Out of date images in implementing a schema plugin
- Creating a working metadata template to be edited HOT 1
- explain tools of the map
- Changelog Review (3.6.0): Formatter page needs updating
- Changelog review (3.6.0): OGC Harvesting Page needs a review
- Changelog Review (3.8.0/3.8.1): Need to include information on custom searches HOT 1
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 doc.