Make all fields linkable directly via an HTML ID (elastic#1148)

Author: Mathieu Martin

docs/field-details.asciidoc

@@ -1,5 +1,5 @@
 '@timestamp':
-  dashed_name: -timestamp
+  dashed_name: timestamp
   description: 'Date/time when the event originated.
 
     This is the date/time extracted from the event, typically representing when the

experimental/generated/ecs/ecs_flat.yml

@@ -158,7 +158,7 @@ base:
     events. These fields are common across all types of events.
   fields:
     '@timestamp':
-      dashed_name: -timestamp
+      dashed_name: timestamp
       description: 'Date/time when the event originated.
 
         This is the date/time extracted from the event, typically representing when

experimental/generated/ecs/ecs_nested.yml

@@ -1,5 +1,5 @@
 '@timestamp':
-  dashed_name: -timestamp
+  dashed_name: timestamp
   description: 'Date/time when the event originated.
 
     This is the date/time extracted from the event, typically representing when the

generated/ecs/ecs_flat.yml

@@ -160,7 +160,7 @@ base:
     events. These fields are common across all types of events.
   fields:
     '@timestamp':
-      dashed_name: -timestamp
+      dashed_name: timestamp
       description: 'Date/time when the event originated.
 
         This is the date/time extracted from the event, typically representing when

generated/ecs/ecs_nested.yml

@@ -173,7 +173,7 @@ def field_finalizer(details, path):
     name_array = path + [details['field_details']['node_name']]
     flat_name = '.'.join(name_array)
     details['field_details']['flat_name'] = flat_name
-    details['field_details']['dashed_name'] = re.sub('[@_\.]', '-', flat_name)
+    details['field_details']['dashed_name'] = re.sub('[_\.]', '-', flat_name).replace('@', '')
     if 'multi_fields' in details['field_details']:
         for mf in details['field_details']['multi_fields']:
             mf['flat_name'] = flat_name + '.' + mf['name']

scripts/schema/finalizer.py

@@ -25,7 +25,10 @@ Find additional usage and examples in the {{ fieldset['name'] }} fields <<ecs-{{
 {% if 'original_fieldset' not in field -%}
 
 {# `Field` column -#}
-| {{ field['flat_name'] }}
+|
+[[field-{{field['dashed_name']}}]]
+<<field-{{field['dashed_name']}}, {{ field['flat_name'] }}>>
+
 {# `Description` column -#}
 | {{ field['description']|replace("\n", "\n\n") }}
 

scripts/templates/field_details.j2

@@ -268,7 +268,7 @@ def test_calculate_final_values(self):
         timestamp_details = base_fields['@timestamp']['field_details']
         self.assertEqual(timestamp_details['flat_name'], '@timestamp',
                          "Field sets with root=true must not namespace field names with the field set's name")
-        self.assertEqual(timestamp_details['dashed_name'], '-timestamp')
+        self.assertEqual(timestamp_details['dashed_name'], 'timestamp')
         # root=false
         self.assertEqual(server_fields['ip']['field_details']['flat_name'], 'server.ip',
                          "Field sets with root=false must namespace field names with the field set's name")
@@ -288,7 +288,7 @@ def test_calculate_final_values(self):
     def test_dashed_name_cleanup(self):
         details = {'field_details': {'node_name': '@time.stamp_'}}
         finalizer.field_finalizer(details, [])
-        self.assertEqual(details['field_details']['dashed_name'], '-time-stamp-')
+        self.assertEqual(details['field_details']['dashed_name'], 'time-stamp-')
 
     # field_group_at_path