Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Spanish version #25626

Closed
rec0mpiled opened this issue Mar 6, 2023 · 8 comments
Closed

Docs: Spanish version #25626

rec0mpiled opened this issue Mar 6, 2023 · 8 comments
Milestone

Comments

@rec0mpiled
Copy link

rec0mpiled commented Mar 6, 2023

Description

Hello, everyone. Thank you for this fantastic project and your hard work in maintaining it.

I'm in love with Three.js and I'd like to contribute to the project by translating the documentation into Spanish (I've worked on a similar project translating Apple's book The Swift Programming Language into Spanish as well — swiftbook.es). Is it okay to use this issue as a source to track the progress of the translation and anything related to it?

UPDATE:

This issue will serve as the source of truth to track the progress of the translation — to know who's working on a given section and any other related aspect.

Please feel free to ask for a section so I can update this to mark it as taken. I also suggest you submit any inquiry or doubt through the Discord channel so we can reach a consensus on the translation of a word, phrase, or grammatical/syntactical construct.

Also, take care of your spelling, it is important that the translation presents good spelling both in accents and in well-written words.

Finally, try to keep a neutral Spanish (assuming such a thing exists 😅), and avoid the use of words that are highly colloquial or exclusive to your region or country, so we can maintain the documentation with a neutral language.

Translation Progress

To translate a section:

  • Check that no one else has claimed the section of your choice in the checklist and comments below. Do not create new issues claiming new work please, let's keep everything here. If you already have an issue opened, please close it after your PR gets merged 🎉. Thanks!

  • Comment below with the name of the section you would like to translate. Take only one section at a time.

  • Submit a PR, assign it to @mprcodes, and add a link to it to your comment!

Status Indicators

  • ✍🏽 – Translation In Progress
  • 👀 – Under Review
  • 🎉 – Done

Sections to Translate

Manual

Getting Started

  • Creating a scene (@mprcodes) ✍🏽
  • Installation (@mprcodes) ✍🏽
  • WebGL compatibility check (@mprcodes) ✍🏽
  • How to run things locally (@mprcodes) ✍🏽
  • Drawing lines (@mprcodes) ✍🏽
  • Creating text (@mprcodes) ✍🏽
  • Loading 3D models (@mprcodes) ✍🏽
  • Libraries and Plugins (@mprcodes) ✍🏽
  • FAQ (@mprcodes) ✍🏽
  • Useful links (@mprcodes) ✍🏽

Next Steps

  • How to update things
  • How to dispose of objects
  • How to create VR content
  • How to use post-processing
  • Matrix transformations
  • Animation system
  • Color management

Build Tools

  • Testing with NPM

Reference

Animation

  • AnimationAction
  • AnimationClip
  • AnimationMixer
  • AnimationObjectGroup
  • AnimationUtils
  • KeyframeTrack
  • PropertyBinding
  • PropertyMixer

Animation / Tracks

  • BooleanKeyframeTrack
  • ColorKeyframeTrack
  • NumberKeyframeTrack
  • QuaternionKeyframeTrack
  • StringKeyframeTrack
  • VectorKeyframeTrack

Audio

  • Audio
  • AudioAnalyser
  • AudioContext
  • AudioListener
  • PositionalAudio

Cameras

  • ArrayCamera
  • Camera
  • CubeCamera
  • OrthographicCamera
  • PerspectiveCamera
  • StereoCamera

Constants

  • Animation
  • Core
  • CustomBlendingEquation
  • BufferAttributeUsage
  • Materials
  • Renderer
  • Textures

Core

  • BufferAttribute
  • BufferGeometry
  • Clock
  • EventDispatcher
  • GLBufferAttribute
  • InstancedBufferAttribute
  • InstancedBufferGeometry
  • InstancedInterleavedBuffer
  • InterleavedBuffer
  • InterleavedBufferAttribute
  • Layers
  • Object3D
  • Raycaster
  • Uniform

Core / BufferAttributes

  • BufferAttribute Types

Extras

  • DataUtils
  • Earcut
  • ImageUtils
  • PMREMGenerator
  • ShapeUtils

Extras / Core

  • Curve
  • CurvePath
  • Interpolations
  • Path
  • Shape
  • ShapePath

Extras / Curves

  • ArcCurve
  • CatmullRomCurve3
  • CubicBezierCurve
  • CubicBezierCurve3
  • EllipseCurve
  • LineCurve
  • LineCurve3
  • QuadraticBezierCurve
  • QuadraticBezierCurve3
  • SplineCurve

Geometries

  • BoxGeometry
  • CapsuleGeometry
  • CircleGeometry
  • ConeGeometry
  • CylinderGeometry
  • DodecahedronGeometry
  • EdgesGeometry
  • ExtrudeGeometry
  • IcosahedronGeometry
  • LatheGeometry
  • OctahedronGeometry
  • PlaneGeometry
  • PolyhedronGeometry
  • RingGeometry
  • ShapeGeometry
  • SphereGeometry
  • TetrahedronGeometry
  • TorusGeometry
  • TorusKnotGeometry
  • TubeGeometry
  • WireframeGeometry

Helpers

  • ArrowHelper
  • AxesHelper
  • BoxHelper
  • Box3Helper
  • CameraHelper
  • DirectionalLightHelper
  • GridHelper
  • PolarGridHelper
  • HemisphereLightHelper
  • PlaneHelper
  • PointLightHelper
  • SkeletonHelper
  • SpotLightHelper

Lights

  • AmbientLight
  • AmbientLightProbe
  • DirectionalLight
  • HemisphereLight
  • HemisphereLightProbe
  • Light
  • LightProbe
  • PointLight
  • RectAreaLight
  • SpotLight

Lights / Shadows

  • LightShadow
  • PointLightShadow
  • DirectionalLightShadow
  • SpotLightShadow

Loaders

  • AnimationLoader
  • AudioLoader
  • BufferGeometryLoader
  • Cache
  • CompressedTextureLoader
  • CubeTextureLoader
  • DataTextureLoader
  • FileLoader
  • ImageBitmapLoader
  • ImageLoader
  • Loader
  • LoaderUtils
  • MaterialLoader
  • ObjectLoader
  • TextureLoader

Loaders / Managers

  • DefaultLoadingManager
  • LoadingManager

Materials

  • LineBasicMaterial
  • LineDashedMaterial
  • Material
  • MeshBasicMaterial
  • MeshDepthMaterial
  • MeshDistanceMaterial
  • MeshLambertMaterial
  • MeshMatcapMaterial
  • MeshNormalMaterial
  • MeshPhongMaterial
  • MeshPhysicalMaterial
  • MeshStandardMaterial
  • MeshToonMaterial
  • PointsMaterial
  • RawShaderMaterial
  • ShaderMaterial
  • ShadowMaterial
  • SpriteMaterial

Math

  • Box2
  • Box3
  • Color
  • Cylindrical
  • Euler
  • Frustum
  • Interpolant
  • Line3
  • MathUtils
  • Matrix3
  • Matrix4
  • Plane
  • Quaternion
  • Ray
  • Sphere
  • Spherical
  • SphericalHarmonics3
  • Triangle
  • Vector2
  • Vector3
  • Vector4

Math / Interpolants

  • CubicInterpolant
  • DiscreteInterpolant
  • LinearInterpolant
  • QuaternionLinearInterpolant

Objects

  • Bone
  • Group
  • InstancedMesh
  • Line
  • LineLoop
  • LineSegments
  • LOD
  • Mesh
  • Points
  • Skeleton
  • SkinnedMesh
  • Sprite

Renderers

  • WebGLMultipleRenderTargets
  • WebGLRenderer
  • WebGL1Renderer
  • WebGLRenderTarget
  • WebGL3DRenderTarget
  • WebGLArrayRenderTarget
    WebGL- [ ] CubeRenderTarget

Renderers / Shaders

  • ShaderChunk
  • ShaderLib
  • UniformsLib
  • UniformsUtils

Renderers / WebXR

  • WebXRManager

Scenes

  • Fog
  • FogExp2
  • Scene

Textures

  • CanvasTexture
  • CompressedTexture
  • CompressedArrayTexture
  • CubeTexture
  • Data3DTexture
  • DataArrayTexture
  • DataTexture
  • DepthTexture
  • FramebufferTexture
  • Source
  • Texture
  • VideoTexture

Addons

Animations

  • CCDIKSolver
  • MMDAnimationHelper
  • MMDPhysics

Controls

  • ArcballControls
  • DragControls
  • FirstPersonControls
  • FlyControls
  • OrbitControls
  • PointerLockControls
  • TrackballControls
  • TransformControls

Geometries

  • ConvexGeometry
  • DecalGeometry
  • ParametricGeometry
  • TextGeometry

Helpers

  • LightProbeHelper
  • PositionalAudioHelper
  • RectAreaLightHelper
  • VertexNormalsHelper
  • VertexTangentsHelper

Lights

  • LightProbeGenerator

Loaders

  • 3DMLoader
  • DRACOLoader
  • FontLoader
  • GLTFLoader
  • KTX2Loader
  • LDrawLoader
  • MMDLoader
  • MTLLoader
  • OBJLoader
  • PCDLoader
  • PDBLoader
  • PRWMLoader
  • SVGLoader
  • TGALoader

Objects

  • Lensflare

Post-Processing

  • EffectComposer

Exporters

  • ColladaExporter
  • DRACOExporter
  • EXRExporter
  • GLTFExporter
  • OBJExporter
  • PLYExporter
  • STLExporter

Math

  • LookupTable
  • MeshSurfaceSampler
  • OBB

ConvexHull

  • Face
  • HalfEdge
  • ConvexHull
  • VertexNode
  • VertexList

Renderers

  • CSS2DRenderer
  • CSS3DRenderer
  • SVGRenderer

Utils

  • BufferGeometryUtils
  • CameraUtils
  • SceneUtils
  • SkeletonUtils

Developer Reference

WebGLRenderer

  • WebGLProgram
@Mugen87
Copy link
Collaborator

Mugen87 commented Mar 7, 2023

Yes, that's fine! In general there is a separate issue per language.

When filing PRs, it's best to translate an entire section (animation, cameras, core) and not individual files. This will make the maintenance/review process easier for us.

@jsebastian2707
Copy link

hey, I'm a computer science student in Colombia, how could help you ?

@AlexisTercero55
Copy link

I'm a Threejs dev from México I want contribute too.

@rec0mpiled
Copy link
Author

Hi, @jsebastian2707 and @AlexisTercero55. Thanks for your interest in helping with the idea. I just updated the issue description to get started with the translations. Take a look at it and act accordingly.

@mrdoob
Copy link
Owner

mrdoob commented Mar 15, 2023

We currently have a problem with documentation translations: #24984

@dev-isaak
Copy link

dev-isaak commented Apr 23, 2023

Hi! I'm a spanish begginer front dev and I would like to contribute translating some sections. I never contribute on github before so if you can help me I will be very grateful.
May I start with "Next steps"?
Thank you!

@mrdoob
Copy link
Owner

mrdoob commented Apr 24, 2023

@dev-isaak Please read #24984

@Mugen87
Copy link
Collaborator

Mugen87 commented Mar 18, 2025

With r175 there will be a new documentation based on JSDoc. The new docs cover the entire code base (core+addons) and support new features like client-side search. However, since the documentation is generated via JSDoc, there is no i18n support. The pages are only available in English.

Translated versions of the documentation are not maintained in this repository anymore, see #24984.

@Mugen87 Mugen87 closed this as completed Mar 18, 2025
@Mugen87 Mugen87 added this to the r175 milestone Mar 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

6 participants