swagger-api/swagger-codegen

generated HTML contains invalid anchor links

Open

#5.087 aberto em 16 de mar. de 2017

Ver no GitHub
 (5 comments) (0 reactions) (0 assignees)HTML (5.474 forks)batch import
Client: HTMLIssue: Bughelp wanted

Métricas do repositório

Stars
 (12.701 stars)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

Description

generated HTML contains invalid anchor links on types of request parameters

Swagger-codegen version

current master; HEAD = 1c160df33897898da1c39f230c737eb6a313e6ba

Swagger declaration file content or url
swagger: "2.0"

info:
  title: swagger-codegen broken anchors to models
  version: '1.0'

definitions:
  foo:
    type: object
    properties:
      x:
        type: string

paths:
  /foo:
    get:
      parameters:
        - name: foo
          in: body
          description: foo
          schema: {$ref: "#/definitions/foo"}
      responses:
        "200":
          description: foo
          type: null
Command line used for generation

JAR=".../swagger-codegen.git/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar" java -jar "${JAR}" generate -i ~/sscce.yaml -l html -o foo

Note in the generated html the link's first letter is capital while the anchor is not. Using Firefox 51.0.1 (64-bit)

Guia do colaborador

Direção de pesquisa
Inspecione o template HTML usado para gerar a documentação (provavelmente um template Mustache) e encontre onde os links de âncora são construídos. Verifique a lógica de capitalização para os alvos da âncora e garanta consistência.
Pilha de tecnologia
javahtml
Domain
backend
Tipo Issue
Bug
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
JavaMustache
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
65